@rulvar/cli 1.223.0 → 1.225.0

package/dist/cli.js

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

package/dist/index.d.ts

@@ -57,7 +57,11 @@ declare function invoiceCommand(argv: string[], context: CommandContext): Promis
 * settle is recorded and 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, which is exactly
-* what a pre-RV1904 journal (the benchmark's own) reports.
+* what a pre-RV1904 journal (the benchmark's own) reports. `--all`
+* (RV2209) runs the same six checks over EVERY run the store lists,
+* 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.
 */
 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-BatQdCln.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-Cc-obcZx.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-BatQdCln.js → io-Cc-obcZx.js}

@@ -560,8 +560,13 @@ const GRAMMAR = {
 	},
 	"cost-audit": {
 		command: "cost-audit",
-		positionals: ["<runId>"],
-		flags: [STORE, { name: "json" }]
+		positionals: [],
+		optionalPositionals: ["<runId>"],
+		flags: [
+			STORE,
+			{ name: "all" },
+			{ name: "json" }
+		]
 	},
 	plan: {
 		command: "plan",
@@ -666,11 +671,16 @@ function renderFlags(flags) {
 	}
 	return tokens;
 }
+/** Optional positionals rendered bracketed, e.g. `[<runId>]` (RV2209). */
+function bracketedOptionals(grammar) {
+	return (grammar.optionalPositionals ?? []).map((placeholder) => `[${placeholder}]`);
+}
 /** The full invocation shape, e.g. `rulvar run <file|name> [--args JSON] ...`. */
 function invocationOf(grammar) {
 	const parts = [
 		`rulvar ${grammar.command}`,
 		...grammar.positionals,
+		...bracketedOptionals(grammar),
 		...renderFlags(grammar.flags)
 	];
 	if (grammar.note !== void 0) parts.push(grammar.note);
@@ -701,7 +711,8 @@ function helpCommandLines() {
 	const heads = top.map((grammar) => [
 		"rulvar",
 		grammar.command,
-		...grammar.positionals
+		...grammar.positionals,
+		...bracketedOptionals(grammar)
 	].join(" "));
 	const kbHead = "rulvar kb <list | inbox | gate | sweep>";
 	const width = Math.max(...heads.map((head) => head.length), 39);
@@ -772,8 +783,9 @@ function parseCommand(grammar, argv) {
 		throw error;
 	}
 	if (raw.positionals.length < grammar.positionals.length) throw new ConfigError(usageOf(grammar));
-	if (raw.positionals.length > grammar.positionals.length) {
-		const extra = raw.positionals[grammar.positionals.length];
+	const maxPositionals = grammar.positionals.length + (grammar.optionalPositionals?.length ?? 0);
+	if (raw.positionals.length > maxPositionals) {
+		const extra = raw.positionals[maxPositionals];
 		throw new ConfigError(`unexpected extra argument '${extra}'; ${usageOf(grammar)}`);
 	}
 	const values = {};
@@ -1284,31 +1296,9 @@ async function invoiceCommand(argv, context) {
 	for (const item of invoice.unpriced) context.io.out(`unpriced: ${item.model} (${item.usage.inputTokens + item.usage.outputTokens} tok)`);
 	return 0;
 }
-/**
-* cost-audit (RV1910): the denominator diagnostic over one stored run.
-* The four-role benchmark's recovery run produced four mutually
-* inconsistent cost views; the lifecycle now admits one, and this
-* command VERIFIES it on a concrete journal instead of trusting the
-* doctrine: the roster is closed (every agent entry terminal), the
-* settle is recorded and 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, which is exactly
-* what a pre-RV1904 journal (the benchmark's own) reports.
-*/
-async function costAuditCommand(argv, context) {
-	const parsed = parseCommand(GRAMMAR["cost-audit"], argv);
-	const runId = parsed.positionals[0];
-	const store = parsed.values.store;
-	const json = parsed.values.json === true;
-	const assembled = assembleEngine({
-		config: await loadCliConfig(context.cwd),
-		...store === void 0 ? {} : { storePath: store },
-		cwd: context.cwd
-	});
-	if (await readRunMeta(assembled.store, runId) === void 0) throw new ConfigError(`run '${runId}' not found in the store`);
-	const entries = await assembled.store.load(runId);
+function auditJournalEntries(entries, basePriceUsd) {
 	const snapshot = journalPricingSnapshot(entries);
-	const composed = snapshot === void 0 ? assembled.priceUsd : snapshot.composedPriceUsd(assembled.priceUsd);
+	const composed = snapshot === void 0 ? basePriceUsd : snapshot.composedPriceUsd(basePriceUsd);
 	const report = costReportFromJournal(entries, composed);
 	const invoice = invoiceFromJournal(entries, composed);
 	const terminalRefs = new Set(entries.filter((entry) => entry.kind === "agent" && entry.status !== "running").map((entry) => entry.ref));
@@ -1371,30 +1361,96 @@ async function costAuditCommand(argv, context) {
 			detail: incrementalMismatches.length === 0 ? "every terminal dispatch set equals its incremental rows (RV2008; absent rows pass)" : `terminal dispatch sets diverge from the incremental rows for agent seq ${incrementalMismatches.join(", ")}`
 		}
 	];
-	const failed = checks.filter((check) => !check.pass);
+	return {
+		report,
+		invoice,
+		checks,
+		failed: checks.filter((check) => !check.pass)
+	};
+}
+/** The one JSON shape of a run's audit, shared by both command forms. */
+function costAuditRunJson(runId, audit) {
+	return {
+		runId,
+		verdict: audit.failed.length === 0 ? "one-denominator" : "divergent",
+		settled: {
+			totalUsd: audit.report.totalUsd,
+			grossUsd: audit.report.grossUsd,
+			wireRequests: audit.report.wireRequests ?? null
+		},
+		invoice: {
+			totalUsd: audit.invoice.totalUsd,
+			rows: audit.invoice.rows.length,
+			wireRequests: audit.invoice.cardinality.wireRequests
+		},
+		checks: audit.checks
+	};
+}
+/**
+* cost-audit (RV1910): the denominator diagnostic over one stored run.
+* The four-role benchmark's recovery run produced four mutually
+* inconsistent cost views; the lifecycle now admits one, and this
+* command VERIFIES it on a concrete journal instead of trusting the
+* doctrine: the roster is closed (every agent entry terminal), the
+* settle is recorded and 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, which is exactly
+* what a pre-RV1904 journal (the benchmark's own) reports. `--all`
+* (RV2209) runs the same six checks over EVERY run the store lists,
+* 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.
+*/
+async function costAuditCommand(argv, context) {
+	const parsed = parseCommand(GRAMMAR["cost-audit"], argv);
+	const runId = parsed.positionals[0];
+	const all = parsed.values.all === true;
+	const store = parsed.values.store;
+	const json = parsed.values.json === true;
+	if (all && runId !== void 0) throw new ConfigError(`--all audits every run of the store; drop the '${runId}' positional; ` + usageOf(GRAMMAR["cost-audit"]));
+	if (!all && runId === void 0) throw new ConfigError(`name a runId, or audit the whole store with --all; ${usageOf(GRAMMAR["cost-audit"])}`);
+	const assembled = assembleEngine({
+		config: await loadCliConfig(context.cwd),
+		...store === void 0 ? {} : { storePath: store },
+		cwd: context.cwd
+	});
+	if (runId !== void 0) {
+		if (await readRunMeta(assembled.store, runId) === void 0) throw new ConfigError(`run '${runId}' not found in the store`);
+		const audit = auditJournalEntries(await assembled.store.load(runId), assembled.priceUsd);
+		if (json) {
+			context.io.out(JSON.stringify(costAuditRunJson(runId, audit), null, 2));
+			return audit.failed.length === 0 ? 0 : 1;
+		}
+		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)}`);
+		for (const check of audit.checks) context.io.out(`  [${check.pass ? "pass" : "FAIL"}] ${check.name}: ${check.detail}`);
+		return audit.failed.length === 0 ? 0 : 1;
+	}
+	const sorted = [...await assembled.store.listRuns()].sort((a, b) => a.runId < b.runId ? -1 : a.runId > b.runId ? 1 : 0);
+	const rows = [];
+	for (const meta of sorted) {
+		const entries = await assembled.store.load(meta.runId);
+		rows.push({
+			runId: meta.runId,
+			audit: auditJournalEntries(entries, assembled.priceUsd)
+		});
+	}
+	const divergent = rows.filter((row) => row.audit.failed.length > 0);
 	if (json) {
 		context.io.out(JSON.stringify({
-			runId,
-			verdict: failed.length === 0 ? "one-denominator" : "divergent",
-			settled: {
-				totalUsd: report.totalUsd,
-				grossUsd: report.grossUsd,
-				wireRequests: report.wireRequests ?? null
-			},
-			invoice: {
-				totalUsd: invoice.totalUsd,
-				rows: invoice.rows.length,
-				wireRequests: invoice.cardinality.wireRequests
-			},
-			checks
+			verdict: divergent.length === 0 ? "one-denominator" : "divergent",
+			divergent: divergent.length,
+			runs: rows.map((row) => costAuditRunJson(row.runId, row.audit))
 		}, null, 2));
-		return failed.length === 0 ? 0 : 1;
+		return divergent.length === 0 ? 0 : 1;
+	}
+	context.io.out(`cost audit: ${String(rows.length)} run${rows.length === 1 ? "" : "s"}, ${String(divergent.length)} divergent`);
+	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")}`);
 	}
-	context.io.out(`run ${runId}: cost audit (${failed.length === 0 ? "one denominator" : "DIVERGENT"})`);
-	context.io.out(`settled: gross $${report.grossUsd.toFixed(4)} | net $${report.totalUsd.toFixed(4)} | wires ${String(report.wireRequests ?? "absent")}`);
-	context.io.out(`invoice: total $${invoice.totalUsd.toFixed(4)} | rows ${String(invoice.rows.length)} | wires ${String(invoice.cardinality.wireRequests)}`);
-	for (const check of checks) context.io.out(`  [${check.pass ? "pass" : "FAIL"}] ${check.name}: ${check.detail}`);
-	return failed.length === 0 ? 0 : 1;
+	return divergent.length === 0 ? 0 : 1;
 }
 /** Formats an optional USD number for the preflight text rows. */
 function usdOf(value) {

package/package.json

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