@qcobro/common 1.12.4 → 1.14.0

package/dist/billing/rates.d.ts

@@ -0,0 +1,108 @@
+import { z } from "zod";
+/**
+ * The billable-meter catalog and per-meter rate schemas.
+ *
+ * The catalog is closed-world: exactly seven meters, one per dispatchable
+ * channel/mode. Message meters bill per message; voice meters bill answered
+ * duration under a telecom increment pair. Each meter kind has its own strict
+ * schema so a rate object with fields from the wrong kind (e.g. `increments`
+ * on `sms`) fails validation instead of being silently ignored.
+ *
+ * The two WhatsApp voice meters are reserved: they must be priced in every
+ * plan, but no dispatch path produces them until Fonoster ships that transport.
+ */
+export declare const MESSAGE_METERS: readonly ["sms", "email", "whatsappMessage"];
+export declare const VOICE_METERS: readonly ["voicePrerecorded", "voiceAi", "whatsappVoicePrerecorded", "whatsappVoiceAi"];
+export declare const BILLING_METERS: readonly ["sms", "email", "whatsappMessage", "voicePrerecorded", "voiceAi", "whatsappVoicePrerecorded", "whatsappVoiceAi"];
+export type MessageMeter = (typeof MESSAGE_METERS)[number];
+export type VoiceMeter = (typeof VOICE_METERS)[number];
+export type BillingMeter = (typeof BILLING_METERS)[number];
+export declare const billingMeterSchema: z.ZodEnum<{
+    sms: "sms";
+    email: "email";
+    whatsappMessage: "whatsappMessage";
+    voicePrerecorded: "voicePrerecorded";
+    voiceAi: "voiceAi";
+    whatsappVoicePrerecorded: "whatsappVoicePrerecorded";
+    whatsappVoiceAi: "whatsappVoiceAi";
+}>;
+/**
+ * Telecom billing-increment notation `"initial/subsequent"` in seconds — the
+ * industry standard (15/15 rounds every call up to 15s blocks; 60/6 bills a
+ * full first minute then 6s steps).
+ */
+export declare const incrementNotationSchema: z.ZodString;
+/** A message meter's rate: decimal currency units per message. */
+export declare const messageRateSchema: z.ZodObject<{
+    perMessage: z.ZodNumber;
+}, z.core.$strict>;
+export type MessageRate = z.infer<typeof messageRateSchema>;
+/** A voice meter's rate: decimal currency units per minute + increment pair. */
+export declare const voiceRateSchema: z.ZodObject<{
+    perMinute: z.ZodNumber;
+    increments: z.ZodString;
+}, z.core.$strict>;
+export type VoiceRate = z.infer<typeof voiceRateSchema>;
+/** A complete rate card: all seven meters, each with its kind's schema. */
+export declare const ratesSchema: z.ZodObject<{
+    sms: z.ZodObject<{
+        perMessage: z.ZodNumber;
+    }, z.core.$strict>;
+    email: z.ZodObject<{
+        perMessage: z.ZodNumber;
+    }, z.core.$strict>;
+    whatsappMessage: z.ZodObject<{
+        perMessage: z.ZodNumber;
+    }, z.core.$strict>;
+    voicePrerecorded: z.ZodObject<{
+        perMinute: z.ZodNumber;
+        increments: z.ZodString;
+    }, z.core.$strict>;
+    voiceAi: z.ZodObject<{
+        perMinute: z.ZodNumber;
+        increments: z.ZodString;
+    }, z.core.$strict>;
+    whatsappVoicePrerecorded: z.ZodObject<{
+        perMinute: z.ZodNumber;
+        increments: z.ZodString;
+    }, z.core.$strict>;
+    whatsappVoiceAi: z.ZodObject<{
+        perMinute: z.ZodNumber;
+        increments: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type Rates = z.infer<typeof ratesSchema>;
+/**
+ * Per-workspace enterprise overrides: any subset of the rate card, validated
+ * with the same per-meter schemas. Stored on workspace billing state (DB),
+ * never in configuration.
+ */
+export declare const rateOverridesSchema: z.ZodObject<{
+    sms: z.ZodOptional<z.ZodObject<{
+        perMessage: z.ZodNumber;
+    }, z.core.$strict>>;
+    email: z.ZodOptional<z.ZodObject<{
+        perMessage: z.ZodNumber;
+    }, z.core.$strict>>;
+    whatsappMessage: z.ZodOptional<z.ZodObject<{
+        perMessage: z.ZodNumber;
+    }, z.core.$strict>>;
+    voicePrerecorded: z.ZodOptional<z.ZodObject<{
+        perMinute: z.ZodNumber;
+        increments: z.ZodString;
+    }, z.core.$strict>>;
+    voiceAi: z.ZodOptional<z.ZodObject<{
+        perMinute: z.ZodNumber;
+        increments: z.ZodString;
+    }, z.core.$strict>>;
+    whatsappVoicePrerecorded: z.ZodOptional<z.ZodObject<{
+        perMinute: z.ZodNumber;
+        increments: z.ZodString;
+    }, z.core.$strict>>;
+    whatsappVoiceAi: z.ZodOptional<z.ZodObject<{
+        perMinute: z.ZodNumber;
+        increments: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type RateOverrides = z.infer<typeof rateOverridesSchema>;
+//# sourceMappingURL=rates.d.ts.map

package/dist/billing/rates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates.d.ts","sourceRoot":"","sources":["../../src/billing/rates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,cAAc,8CAA+C,CAAC;AAC3E,eAAO,MAAM,YAAY,yFAKf,CAAC;AACX,eAAO,MAAM,cAAc,4HAAgD,CAAC;AAE5E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,kBAAkB;;;;;;;;EAAyB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,aAKjC,CAAC;AAEJ,kEAAkE;AAClE,eAAO,MAAM,iBAAiB;;kBAE5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,gFAAgF;AAChF,eAAO,MAAM,eAAe;;;kBAG1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,2EAA2E;AAC3E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAwB,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/billing/rates.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+/**
+ * The billable-meter catalog and per-meter rate schemas.
+ *
+ * The catalog is closed-world: exactly seven meters, one per dispatchable
+ * channel/mode. Message meters bill per message; voice meters bill answered
+ * duration under a telecom increment pair. Each meter kind has its own strict
+ * schema so a rate object with fields from the wrong kind (e.g. `increments`
+ * on `sms`) fails validation instead of being silently ignored.
+ *
+ * The two WhatsApp voice meters are reserved: they must be priced in every
+ * plan, but no dispatch path produces them until Fonoster ships that transport.
+ */
+export const MESSAGE_METERS = ["sms", "email", "whatsappMessage"];
+export const VOICE_METERS = [
+    "voicePrerecorded",
+    "voiceAi",
+    "whatsappVoicePrerecorded",
+    "whatsappVoiceAi"
+];
+export const BILLING_METERS = [...MESSAGE_METERS, ...VOICE_METERS];
+export const billingMeterSchema = z.enum(BILLING_METERS);
+/**
+ * Telecom billing-increment notation `"initial/subsequent"` in seconds — the
+ * industry standard (15/15 rounds every call up to 15s blocks; 60/6 bills a
+ * full first minute then 6s steps).
+ */
+export const incrementNotationSchema = z
+    .string()
+    .regex(/^[1-9]\d*\/[1-9]\d*$/, 'increments must be "initial/subsequent" in positive whole seconds (e.g. "15/15")');
+/** A message meter's rate: decimal currency units per message. */
+export const messageRateSchema = z.strictObject({
+    perMessage: z.number().positive()
+});
+/** A voice meter's rate: decimal currency units per minute + increment pair. */
+export const voiceRateSchema = z.strictObject({
+    perMinute: z.number().positive(),
+    increments: incrementNotationSchema
+});
+/** A complete rate card: all seven meters, each with its kind's schema. */
+export const ratesSchema = z.strictObject({
+    sms: messageRateSchema,
+    email: messageRateSchema,
+    whatsappMessage: messageRateSchema,
+    voicePrerecorded: voiceRateSchema,
+    voiceAi: voiceRateSchema,
+    whatsappVoicePrerecorded: voiceRateSchema,
+    whatsappVoiceAi: voiceRateSchema
+});
+/**
+ * Per-workspace enterprise overrides: any subset of the rate card, validated
+ * with the same per-meter schemas. Stored on workspace billing state (DB),
+ * never in configuration.
+ */
+export const rateOverridesSchema = ratesSchema.partial();
+//# sourceMappingURL=rates.js.map

package/dist/billing/rates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates.js","sourceRoot":"","sources":["../../src/billing/rates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,iBAAiB,CAAU,CAAC;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,kBAAkB;IAClB,SAAS;IACT,0BAA0B;IAC1B,iBAAiB;CACT,CAAC;AACX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAG,cAAc,EAAE,GAAG,YAAY,CAAU,CAAC;AAM5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,EAAE;KACR,KAAK,CACJ,sBAAsB,EACtB,kFAAkF,CACnF,CAAC;AAEJ,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAGH,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,uBAAuB;CACpC,CAAC,CAAC;AAGH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC;IACxC,GAAG,EAAE,iBAAiB;IACtB,KAAK,EAAE,iBAAiB;IACxB,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,eAAe;IACjC,OAAO,EAAE,eAAe;IACxB,wBAAwB,EAAE,eAAe;IACzC,eAAe,EAAE,eAAe;CACjC,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC"}

package/dist/bin/engineEval.d.ts

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { type EvaluationParameters, type Scorecard } from "../evaluation/scorecard.js";
+/**
+ * `engine-eval` — the npx-runnable judge client (engine-scorecard capability,
+ * requirement "A deployment can be evaluated with npx"). Fetches the flight-
+ * recorder stream + engine parameters from a deployment's
+ * `GET /api/engine/events`, runs the pure `evaluate` from this same package
+ * locally, and prints the resulting scorecard. No repository checkout,
+ * database access, or config file is required — only the API URL and a
+ * workspace API key pair. All imports below are relative (this file ships
+ * inside `@qcobro/common`; it must not import its own package by name).
+ */
+export declare const DEFAULT_URL = "https://api.qcobro.com";
+export interface CliOptions {
+    url: string;
+    from?: string;
+    to?: string;
+    accessKeyId?: string;
+    accessKeySecret?: string;
+    latencyP95?: number;
+    maxErrorRate?: number;
+    livenessTicks?: number;
+    json: boolean;
+    help: boolean;
+}
+export declare const USAGE = "Usage: engine-eval [options]\n\nEvaluate a QCobro deployment's campaigns-engine event stream against the\nbuilt-in invariant catalog (safety, performance, liveness) and print a\nscorecard. Exits non-zero when the overall verdict is fail.\n\nOptions:\n  --url <url>                   Deployment API base URL (default: https://api.qcobro.com)\n  --from <iso>                  Range start (ISO datetime)\n  --to <iso>                    Range end (ISO datetime)\n                                 (omit both to evaluate today, operator's local timezone)\n  --access-key-id <id>          Workspace API key id (or QCOBRO_ACCESS_KEY_ID)\n  --access-key-secret <secret>  Workspace API key secret (or QCOBRO_ACCESS_KEY_SECRET)\n  --latency-p95 <ms>            Override PERF-2 threshold (dispatch latency p95, ms)\n  --max-error-rate <0..1>       Override PERF-3 threshold (max per-channel error rate)\n  --liveness-ticks <n>          Override LIVE-1 threshold (ticks to first attempt)\n  --json                        Print the scorecard as JSON instead of text\n  --help                        Show this help\n\nExit codes: 0 = pass, 1 = fail, 2 = usage/network/auth error.\n";
+/** Raised for usage, network, or auth failures — mapped to exit code 2. */
+export declare class CliError extends Error {
+}
+/** Parses argv into typed options. Throws `CliError` on malformed flags. */
+export declare function parseCliArgs(argv: string[]): CliOptions;
+/**
+ * Resolves the from/to range. When BOTH flags are omitted, defaults to today
+ * in the operator's local timezone (the machine running the CLI): local
+ * midnight through now. When either flag is given, both are passed through
+ * unchanged (no default is applied to just one side).
+ */
+export declare function resolveRange(from: string | undefined, to: string | undefined, now: Date): {
+    from?: string;
+    to?: string;
+};
+/** Resolves the API key pair from flags, falling back to environment variables. */
+export declare function resolveCredentials(opts: Pick<CliOptions, "accessKeyId" | "accessKeySecret">, env: Record<string, string | undefined>): {
+    accessKeyId: string;
+    accessKeySecret: string;
+};
+/** Builds only the threshold overrides the operator actually passed. */
+export declare function buildThresholdOverrides(opts: Pick<CliOptions, "latencyP95" | "maxErrorRate" | "livenessTicks">): Partial<EvaluationParameters["thresholds"]>;
+/**
+ * Renders rows as aligned columns: each column as wide as its widest cell,
+ * numeric-looking cells right-aligned, two spaces between columns. Width is
+ * computed from the data, so alignment holds for any campaign name or count.
+ */
+export declare function alignColumns(rows: string[][], indent?: string): string[];
+/** Renders the scorecard as a plain-ASCII, human-readable summary. */
+export declare function formatScorecard(scorecard: Scorecard, ctx: {
+    url: string;
+    from?: string;
+    to?: string;
+}): string;
+/**
+ * Entry point. Exported (rather than only run inline) so it can be exercised
+ * directly if ever needed; the module also self-invokes when run via `node`
+ * or `npx` (see the guard at the bottom of the file).
+ */
+export declare function main(argv?: string[], env?: Record<string, string | undefined>, now?: Date, stdout?: (s: string) => void, stderr?: (s: string) => void): Promise<number>;
+//# sourceMappingURL=engineEval.d.ts.map

package/dist/bin/engineEval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineEval.d.ts","sourceRoot":"","sources":["../../src/bin/engineEval.ts"],"names":[],"mappings":";AAGA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,4BAA4B,CAAC;AAGpC;;;;;;;;;GASG;AAEH,eAAO,MAAM,WAAW,2BAA2B,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,eAAO,MAAM,KAAK,opCAoBjB,CAAC;AAEF,2EAA2E;AAC3E,qBAAa,QAAS,SAAQ,KAAK;CAAG;AAwBtC,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmBvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,GAAG,EAAE,IAAI,GACR;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAMhC;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,CAAC,EACzD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAUlD;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,cAAc,GAAG,eAAe,CAAC,GACtE,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAM7C;AA6CD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,SAAO,GAAG,MAAM,EAAE,CAqBtE;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,MAAM,CA4ER;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CACxB,IAAI,GAAE,MAAM,EAA0B,EACtC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,GAAG,GAAE,IAAiB,EACtB,MAAM,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAqC,EAC5D,MAAM,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAqC,GAC3D,OAAO,CAAC,MAAM,CAAC,CA8CjB"}

package/dist/bin/engineEval.js

@@ -0,0 +1,290 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { evaluate } from "../evaluation/evaluate.js";
+import { evaluationParametersSchema } from "../evaluation/scorecard.js";
+/**
+ * `engine-eval` — the npx-runnable judge client (engine-scorecard capability,
+ * requirement "A deployment can be evaluated with npx"). Fetches the flight-
+ * recorder stream + engine parameters from a deployment's
+ * `GET /api/engine/events`, runs the pure `evaluate` from this same package
+ * locally, and prints the resulting scorecard. No repository checkout,
+ * database access, or config file is required — only the API URL and a
+ * workspace API key pair. All imports below are relative (this file ships
+ * inside `@qcobro/common`; it must not import its own package by name).
+ */
+export const DEFAULT_URL = "https://api.qcobro.com";
+export const USAGE = `Usage: engine-eval [options]
+
+Evaluate a QCobro deployment's campaigns-engine event stream against the
+built-in invariant catalog (safety, performance, liveness) and print a
+scorecard. Exits non-zero when the overall verdict is fail.
+
+Options:
+  --url <url>                   Deployment API base URL (default: ${DEFAULT_URL})
+  --from <iso>                  Range start (ISO datetime)
+  --to <iso>                    Range end (ISO datetime)
+                                 (omit both to evaluate today, operator's local timezone)
+  --access-key-id <id>          Workspace API key id (or QCOBRO_ACCESS_KEY_ID)
+  --access-key-secret <secret>  Workspace API key secret (or QCOBRO_ACCESS_KEY_SECRET)
+  --latency-p95 <ms>            Override PERF-2 threshold (dispatch latency p95, ms)
+  --max-error-rate <0..1>       Override PERF-3 threshold (max per-channel error rate)
+  --liveness-ticks <n>          Override LIVE-1 threshold (ticks to first attempt)
+  --json                        Print the scorecard as JSON instead of text
+  --help                        Show this help
+
+Exit codes: 0 = pass, 1 = fail, 2 = usage/network/auth error.
+`;
+/** Raised for usage, network, or auth failures — mapped to exit code 2. */
+export class CliError extends Error {
+}
+const OPTION_SPEC = {
+    url: { type: "string" },
+    from: { type: "string" },
+    to: { type: "string" },
+    "access-key-id": { type: "string" },
+    "access-key-secret": { type: "string" },
+    "latency-p95": { type: "string" },
+    "max-error-rate": { type: "string" },
+    "liveness-ticks": { type: "string" },
+    json: { type: "boolean", default: false },
+    help: { type: "boolean", default: false }
+};
+function parseNumberFlag(flag, raw) {
+    if (raw === undefined)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isFinite(value)) {
+        throw new CliError(`--${flag} must be a number, got "${raw}"`);
+    }
+    return value;
+}
+/** Parses argv into typed options. Throws `CliError` on malformed flags. */
+export function parseCliArgs(argv) {
+    let values;
+    try {
+        ({ values } = parseArgs({ args: argv, options: OPTION_SPEC, allowPositionals: false }));
+    }
+    catch (err) {
+        throw new CliError(`Invalid arguments: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return {
+        url: values.url ?? DEFAULT_URL,
+        from: values.from,
+        to: values.to,
+        accessKeyId: values["access-key-id"],
+        accessKeySecret: values["access-key-secret"],
+        latencyP95: parseNumberFlag("latency-p95", values["latency-p95"]),
+        maxErrorRate: parseNumberFlag("max-error-rate", values["max-error-rate"]),
+        livenessTicks: parseNumberFlag("liveness-ticks", values["liveness-ticks"]),
+        json: values.json ?? false,
+        help: values.help ?? false
+    };
+}
+/**
+ * Resolves the from/to range. When BOTH flags are omitted, defaults to today
+ * in the operator's local timezone (the machine running the CLI): local
+ * midnight through now. When either flag is given, both are passed through
+ * unchanged (no default is applied to just one side).
+ */
+export function resolveRange(from, to, now) {
+    if (from === undefined && to === undefined) {
+        const localMidnight = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 0, 0);
+        return { from: localMidnight.toISOString(), to: now.toISOString() };
+    }
+    return { from, to };
+}
+/** Resolves the API key pair from flags, falling back to environment variables. */
+export function resolveCredentials(opts, env) {
+    const accessKeyId = opts.accessKeyId ?? env.QCOBRO_ACCESS_KEY_ID;
+    const accessKeySecret = opts.accessKeySecret ?? env.QCOBRO_ACCESS_KEY_SECRET;
+    if (!accessKeyId || !accessKeySecret) {
+        throw new CliError("Missing API key credentials: pass --access-key-id/--access-key-secret or set " +
+            "QCOBRO_ACCESS_KEY_ID/QCOBRO_ACCESS_KEY_SECRET");
+    }
+    return { accessKeyId, accessKeySecret };
+}
+/** Builds only the threshold overrides the operator actually passed. */
+export function buildThresholdOverrides(opts) {
+    const thresholds = {};
+    if (opts.latencyP95 !== undefined)
+        thresholds.dispatchLatencyP95Ms = opts.latencyP95;
+    if (opts.maxErrorRate !== undefined)
+        thresholds.maxErrorRate = opts.maxErrorRate;
+    if (opts.livenessTicks !== undefined)
+        thresholds.livenessTicks = opts.livenessTicks;
+    return thresholds;
+}
+async function fetchEvents(url, range, accessKeyId, accessKeySecret) {
+    let endpoint;
+    try {
+        endpoint = new URL("/api/engine/events", url);
+    }
+    catch {
+        throw new CliError(`Invalid --url "${url}"`);
+    }
+    if (range.from)
+        endpoint.searchParams.set("from", range.from);
+    if (range.to)
+        endpoint.searchParams.set("to", range.to);
+    const auth = Buffer.from(`${accessKeyId}:${accessKeySecret}`).toString("base64");
+    let res;
+    try {
+        res = await fetch(endpoint, { headers: { Authorization: `Basic ${auth}` } });
+    }
+    catch (err) {
+        throw new CliError(`Could not reach ${endpoint.origin}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (res.status === 401) {
+        throw new CliError("Authentication failed: invalid API key credentials");
+    }
+    if (!res.ok) {
+        throw new CliError(`Request failed: ${res.status} ${res.statusText}`);
+    }
+    return (await res.json());
+}
+/**
+ * Renders rows as aligned columns: each column as wide as its widest cell,
+ * numeric-looking cells right-aligned, two spaces between columns. Width is
+ * computed from the data, so alignment holds for any campaign name or count.
+ */
+export function alignColumns(rows, indent = "  ") {
+    const widths = [];
+    for (const row of rows) {
+        row.forEach((cell, i) => {
+            widths[i] = Math.max(widths[i] ?? 0, cell.length);
+        });
+    }
+    const numeric = /^[\d,.%]+$/;
+    return rows.map((row) => (indent +
+        row
+            .map((cell, i) => {
+            const w = widths[i];
+            // Last column flows free; numbers right-align under their header.
+            if (i === row.length - 1)
+                return cell;
+            return numeric.test(cell) ? cell.padStart(w) : cell.padEnd(w);
+        })
+            .join("  ")).trimEnd());
+}
+/** Renders the scorecard as a plain-ASCII, human-readable summary. */
+export function formatScorecard(scorecard, ctx) {
+    const lines = [];
+    lines.push("QCobro engine-eval");
+    lines.push(`url:    ${ctx.url}`);
+    lines.push(`range:  ${ctx.from ?? "(unbounded)"} .. ${ctx.to ?? "(unbounded)"}`);
+    lines.push(`totals: events=${scorecard.totals.events} ticks=${scorecard.totals.ticks} ` +
+        `campaigns=${scorecard.totals.campaigns} accountsConsidered=${scorecard.totals.accountsConsidered}`);
+    if (scorecard.gaps.length === 0) {
+        lines.push("gaps:   none");
+    }
+    else {
+        lines.push(`gaps:   ${scorecard.gaps.length} tick(s) started but never completed`);
+        for (const g of scorecard.gaps)
+            lines.push(`  - tick ${g.tickId} at ${g.at}`);
+    }
+    lines.push("");
+    lines.push(`VERDICT: ${scorecard.verdict.toUpperCase()}`);
+    lines.push("");
+    lines.push("INVARIANTS");
+    lines.push(...alignColumns(scorecard.invariants.map((inv) => [
+        `[${inv.verdict === "pass" ? "PASS" : "FAIL"}]`,
+        inv.id,
+        inv.name,
+        inv.scope,
+        inv.metric ?? ""
+    ])));
+    lines.push("");
+    lines.push("BY CAMPAIGN");
+    // Names come from the stream's campaign.evaluated events; streams recorded
+    // before names existed fall back to the id.
+    const campaignName = new Map(scorecard.campaigns.map((c) => [c.campaignId, c.name]));
+    const displayName = (id) => campaignName.get(id) ?? id;
+    if (scorecard.campaigns.length === 0) {
+        lines.push("  (no campaigns in range)");
+    }
+    else {
+        lines.push(...alignColumns([
+            ["campaign", "ticks", "considered", "dispatched", "failed", "suppressed", "violations"],
+            ...scorecard.campaigns.map((c) => [
+                c.name ?? c.campaignId,
+                String(c.ticksSeen),
+                String(c.considered),
+                String(c.dispatched),
+                String(c.failed),
+                String(c.suppressed),
+                Object.entries(c.violations)
+                    .map(([id, count]) => `${id}:${count}`)
+                    .join(" ") || "-"
+            ])
+        ]));
+    }
+    const violating = scorecard.invariants.filter((inv) => inv.violations.length > 0);
+    if (violating.length > 0) {
+        lines.push("");
+        lines.push("VIOLATIONS");
+        for (const inv of violating) {
+            lines.push(`  ${inv.id} ${inv.name}`);
+            for (const v of inv.violations) {
+                const scope = [
+                    v.campaignId ? `campaign "${displayName(v.campaignId)}"` : undefined,
+                    v.portfolioAccountId ? `account ${v.portfolioAccountId}` : undefined
+                ]
+                    .filter((s) => Boolean(s))
+                    .join(", ");
+                lines.push(`    - ${scope ? scope + ": " : ""}${v.detail} [events: ${v.eventIds.join(", ")}]`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Entry point. Exported (rather than only run inline) so it can be exercised
+ * directly if ever needed; the module also self-invokes when run via `node`
+ * or `npx` (see the guard at the bottom of the file).
+ */
+export async function main(argv = process.argv.slice(2), env = process.env, now = new Date(), stdout = (s) => process.stdout.write(s), stderr = (s) => process.stderr.write(s)) {
+    let opts;
+    try {
+        opts = parseCliArgs(argv);
+    }
+    catch (err) {
+        stderr(`engine-eval: ${err instanceof Error ? err.message : String(err)}\n\n${USAGE}`);
+        return 2;
+    }
+    if (opts.help) {
+        stdout(USAGE);
+        return 0;
+    }
+    try {
+        const { accessKeyId, accessKeySecret } = resolveCredentials(opts, env);
+        const range = resolveRange(opts.from, opts.to, now);
+        const { events, parameters, truncated } = await fetchEvents(opts.url, range, accessKeyId, accessKeySecret);
+        if (truncated) {
+            stderr("engine-eval: warning — the server truncated the event stream for this range; " +
+                "verdicts may miss violations. Narrow --from/--to and re-run.\n");
+        }
+        const evaluationParameters = evaluationParametersSchema.parse({
+            tickSeconds: parameters.tickSeconds,
+            ratesPerMinute: parameters.ratesPerMinute,
+            thresholds: buildThresholdOverrides(opts)
+        });
+        const scorecard = evaluate(events, evaluationParameters);
+        if (opts.json) {
+            stdout(JSON.stringify(scorecard, null, 2) + "\n");
+        }
+        else {
+            stdout(formatScorecard(scorecard, { url: opts.url, from: range.from, to: range.to }) + "\n");
+        }
+        return scorecard.verdict === "pass" ? 0 : 1;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        stderr(`engine-eval: ${message}\n`);
+        return 2;
+    }
+}
+// Only run when this file is the process entry point (not when imported by tests).
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().then((code) => process.exit(code));
+}
+//# sourceMappingURL=engineEval.js.map

package/dist/bin/engineEval.js.map

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