agentskeptic 1.1.0 → 1.1.1

package/dist/commercial/getCurrentUsage.d.ts

@@ -0,0 +1,16 @@
+export type CurrentUsageResponse = {
+    schema_version: 1;
+    plan: "starter" | "individual" | "team" | "business" | "enterprise";
+    year_month: string;
+    period_start_utc: string;
+    period_end_utc: string;
+    used_total: number;
+    included_monthly: number | null;
+    allow_overage: boolean;
+    overage_count: number;
+    quota_state: "ok" | "notice" | "warning" | "in_overage" | "at_cap";
+    allowed_next: boolean;
+    estimated_overage_usd: string;
+};
+export declare function fetchCurrentUsage(): Promise<CurrentUsageResponse>;
+//# sourceMappingURL=getCurrentUsage.d.ts.map

package/dist/commercial/getCurrentUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrentUsage.d.ts","sourceRoot":"","sources":["../../src/commercial/getCurrentUsage.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;IACnE,YAAY,EAAE,OAAO,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAsCvE"}

package/dist/commercial/getCurrentUsage.js

@@ -0,0 +1,33 @@
+import { TruthLayerError } from "../truthLayerError.js";
+import { CLI_OPERATIONAL_CODES } from "../cliOperationalCodes.js";
+import { LICENSE_API_BASE_URL, LICENSE_PREFLIGHT_ENABLED } from "../generated/commercialBuildFlags.js";
+export async function fetchCurrentUsage() {
+    if (!LICENSE_PREFLIGHT_ENABLED) {
+        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, "Current usage is available only in commercial builds.");
+    }
+    const apiKey = process.env.AGENTSKEPTIC_API_KEY?.trim() ||
+        process.env.WORKFLOW_VERIFIER_API_KEY?.trim();
+    if (!apiKey) {
+        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_KEY_MISSING, "Commercial agentskeptic requires AGENTSKEPTIC_API_KEY.");
+    }
+    const url = `${LICENSE_API_BASE_URL.replace(/\/$/, "")}/api/v1/usage/current`;
+    const res = await fetch(url, {
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "x-request-id": crypto.randomUUID(),
+        },
+    });
+    const text = await res.text();
+    let parsed = null;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        parsed = null;
+    }
+    if (!res.ok || !parsed || typeof parsed !== "object") {
+        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_USAGE_UNAVAILABLE, `Could not load current usage (HTTP ${res.status}).`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=getCurrentUsage.js.map

package/dist/commercial/getCurrentUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrentUsage.js","sourceRoot":"","sources":["../../src/commercial/getCurrentUsage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAiBvG,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,mBAAmB,EACzC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC;IAC9E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,EAAE;YACjC,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE;SACpC;KACF,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,MAAM,GAAY,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,yBAAyB,EAC/C,sCAAsC,GAAG,CAAC,MAAM,IAAI,CACrD,CAAC;IACJ,CAAC;IACD,OAAO,MAA8B,CAAC;AACxC,CAAC"}

package/dist/commercial/licensePreflight.d.ts

@@ -8,5 +8,6 @@ export type LicensePreflightResult = {
  */
 export declare function runLicensePreflightIfNeeded(intent?: LicensePreflightIntent, opts?: {
     runId?: string;
+    xRequestId?: string;
 }): Promise<LicensePreflightResult>;
 //# sourceMappingURL=licensePreflight.d.ts.map

package/dist/commercial/licensePreflight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"licensePreflight.d.ts","sourceRoot":"","sources":["../../src/commercial/licensePreflight.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAoB1D,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE9D;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,GAAE,sBAAiC,EACzC,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAqHjC"}
+{"version":3,"file":"licensePreflight.d.ts","sourceRoot":"","sources":["../../src/commercial/licensePreflight.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAoB1D,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAO9D;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,GAAE,sBAAiC,EACzC,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,sBAAsB,CAAC,CAiJjC"}

package/dist/commercial/licensePreflight.js

@@ -5,6 +5,10 @@ const RETRY_MS = [250, 750, 2250];
 function sleep(ms) {
     return new Promise((r) => setTimeout(r, ms));
 }
+function requestIdSuffix(res) {
+    const rid = res.headers.get("x-request-id")?.trim();
+    return rid ? ` [x-request-id=${rid}]` : "";
+}
 /**
  * Before contract-mode verification (commercial npm build), contact license API.
  * Returns `{ runId: null }` when LICENSE_PREFLIGHT_ENABLED is false (OSS profile).
@@ -21,6 +25,7 @@ export async function runLicensePreflightIfNeeded(intent = "verify", opts) {
         process.env.AGENTSKEPTIC_RUN_ID?.trim() ||
         process.env.WORKFLOW_VERIFIER_RUN_ID?.trim() ||
         crypto.randomUUID();
+    const xRequestId = opts?.xRequestId?.trim() || crypto.randomUUID();
     const issuedAt = new Date().toISOString();
     const url = `${LICENSE_API_BASE_URL.replace(/\/$/, "")}/api/v1/usage/reserve`;
     let lastErr;
@@ -31,6 +36,7 @@ export async function runLicensePreflightIfNeeded(intent = "verify", opts) {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
                     "Content-Type": "application/json",
+                    "x-request-id": xRequestId,
                 },
                 body: JSON.stringify({ run_id: runId, issued_at: issuedAt, intent }),
             });
@@ -42,11 +48,12 @@ export async function runLicensePreflightIfNeeded(intent = "verify", opts) {
             catch {
                 body = null;
             }
+            const rid = requestIdSuffix(res);
             if (res.status === 429 ||
                 res.status === 502 ||
                 res.status === 503 ||
                 res.status === 504) {
-                lastErr = new Error(`HTTP ${res.status}`);
+                lastErr = new Error(`HTTP ${res.status}${rid}`);
                 if (attempt < RETRY_MS.length)
                     await sleep(RETRY_MS[attempt]);
                 continue;
@@ -57,28 +64,40 @@ export async function runLicensePreflightIfNeeded(intent = "verify", opts) {
                         const suffix = body.upgrade_url
                             ? ` ${body.upgrade_url}`
                             : "";
-                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.ENFORCEMENT_REQUIRES_PAID_PLAN, `${body.message || "Enforcement requires a paid plan."}${suffix}`);
+                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.ENFORCEMENT_REQUIRES_PAID_PLAN, `${body.message || "Enforcement requires a paid plan."}${suffix}${rid}`);
                     }
                     if (body.code === "VERIFICATION_REQUIRES_SUBSCRIPTION") {
                         const suffix = body.upgrade_url
                             ? ` ${body.upgrade_url}`
                             : "";
-                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.VERIFICATION_REQUIRES_SUBSCRIPTION, `${body.message || "Licensed verification requires an active subscription."}${suffix}`);
+                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.VERIFICATION_REQUIRES_SUBSCRIPTION, `${body.message || "Licensed verification requires an active subscription."}${suffix}${rid}`);
                     }
                     if (body.code === "SUBSCRIPTION_INACTIVE") {
                         const suffix = body.upgrade_url ? ` ${body.upgrade_url}` : "";
-                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || "Subscription is not active for licensed verification or CI enforcement."}${suffix}`);
+                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || "Subscription is not active for licensed verification or CI enforcement."}${suffix}${rid}`);
                     }
                     if (body.code === "BILLING_PRICE_UNMAPPED") {
                         const suffix = body.upgrade_url ? ` ${body.upgrade_url}` : "";
-                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || "Stripe price is not mapped in this deployment."}${suffix}`);
+                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || "Stripe price is not mapped in this deployment."}${suffix}${rid}`);
+                    }
+                    if (body.code === "INSUFFICIENT_SCOPE") {
+                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || "API key does not include required scope for this operation."}${rid}`);
+                    }
+                    if (body.code === "KEY_EXPIRED") {
+                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || "API key is expired."}${rid}`);
+                    }
+                    if (body.code === "KEY_REVOKED") {
+                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || "API key is revoked."}${rid}`);
+                    }
+                    if (body.code === "KEY_DISABLED") {
+                        throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || "API key is disabled."}${rid}`);
                     }
-                    throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, body.message || `License check failed (${body.code}).`);
+                    throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `${body.message || `License check failed (${body.code}).`}${rid}`);
                 }
-                throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `License check failed with HTTP ${res.status}.`);
+                throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `License check failed with HTTP ${res.status}.${rid}`);
             }
             if (!body || body.allowed !== true) {
-                throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, "License server returned an unexpected response.");
+                throw new TruthLayerError(CLI_OPERATIONAL_CODES.LICENSE_DENIED, `License server returned an unexpected response.${rid}`);
             }
             return { runId };
         }

package/dist/commercial/licensePreflight.js.map

@@ -1 +1 @@
-{"version":3,"file":"licensePreflight.js","sourceRoot":"","sources":["../../src/commercial/licensePreflight.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"licensePreflight.js","sourceRoot":"","sources":["../../src/commercial/licensePreflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,sCAAsC,CAAC;AAE9C,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAU,CAAC;AAE3C,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAwBD,SAAS,eAAe,CAAC,GAAa;IACpC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC;IACpD,OAAO,GAAG,CAAC,CAAC,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,SAAiC,QAAQ,EACzC,IAA8C;IAE9C,IAAI,CAAC,yBAAyB;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAEvD,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,mBAAmB,EACzC,uLAAuL,CACxL,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GACT,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QACnB,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE;QACvC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,EAAE;QAC5C,MAAM,CAAC,UAAU,EAAE,CAAC;IACtB,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;IACnE,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC;IAE9E,IAAI,OAAgB,CAAC;IACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,MAAM,EAAE;oBACjC,cAAc,EAAE,kBAAkB;oBAClC,cAAc,EAAE,UAAU;iBAC3B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;aACrE,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,GAAuB,IAAI,CAAC;YACpC,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,GAAG,IAAI,CAAC;YACd,CAAC;YAED,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YAEjC,IACE,GAAG,CAAC,MAAM,KAAK,GAAG;gBAClB,GAAG,CAAC,MAAM,KAAK,GAAG;gBAClB,GAAG,CAAC,MAAM,KAAK,GAAG;gBAClB,GAAG,CAAC,MAAM,KAAK,GAAG,EAClB,CAAC;gBACD,OAAO,GAAG,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;gBAChD,IAAI,OAAO,GAAG,QAAQ,CAAC,MAAM;oBAAE,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAE,CAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;oBACnC,IAAI,IAAI,CAAC,IAAI,KAAK,gCAAgC,EAAE,CAAC;wBACnD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW;4BAC7B,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE;4BACxB,CAAC,CAAC,EAAE,CAAC;wBACP,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,8BAA8B,EACpD,GAAG,IAAI,CAAC,OAAO,IAAI,mCAAmC,GAAG,MAAM,GAAG,GAAG,EAAE,CACxE,CAAC;oBACJ,CAAC;oBACD,IAAI,IAAI,CAAC,IAAI,KAAK,oCAAoC,EAAE,CAAC;wBACvD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW;4BAC7B,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE;4BACxB,CAAC,CAAC,EAAE,CAAC;wBACP,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,kCAAkC,EACxD,GAAG,IAAI,CAAC,OAAO,IAAI,wDAAwD,GAAG,MAAM,GAAG,GAAG,EAAE,CAC7F,CAAC;oBACJ,CAAC;oBACD,IAAI,IAAI,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;wBAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC9D,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,GAAG,IAAI,CAAC,OAAO,IAAI,yEAAyE,GAAG,MAAM,GAAG,GAAG,EAAE,CAC9G,CAAC;oBACJ,CAAC;oBACD,IAAI,IAAI,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;wBAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC9D,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,GAAG,IAAI,CAAC,OAAO,IAAI,gDAAgD,GAAG,MAAM,GAAG,GAAG,EAAE,CACrF,CAAC;oBACJ,CAAC;oBACD,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;wBACvC,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,GAAG,IAAI,CAAC,OAAO,IAAI,6DAA6D,GAAG,GAAG,EAAE,CACzF,CAAC;oBACJ,CAAC;oBACD,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;wBAChC,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,GAAG,IAAI,CAAC,OAAO,IAAI,qBAAqB,GAAG,GAAG,EAAE,CACjD,CAAC;oBACJ,CAAC;oBACD,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;wBAChC,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,GAAG,IAAI,CAAC,OAAO,IAAI,qBAAqB,GAAG,GAAG,EAAE,CACjD,CAAC;oBACJ,CAAC;oBACD,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;wBACjC,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,GAAG,IAAI,CAAC,OAAO,IAAI,sBAAsB,GAAG,GAAG,EAAE,CAClD,CAAC;oBACJ,CAAC;oBACD,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,GAAG,IAAI,CAAC,OAAO,IAAI,yBAAyB,IAAI,CAAC,IAAI,IAAI,GAAG,GAAG,EAAE,CAClE,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,kCAAkC,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CACtD,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,cAAc,EACpC,kDAAkD,GAAG,EAAE,CACxD,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,eAAe;gBAAE,MAAM,CAAC,CAAC;YAC1C,OAAO,GAAG,CAAC,CAAC;YACZ,IAAI,OAAO,GAAG,QAAQ,CAAC,MAAM;gBAAE,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GACP,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;IAC5E,MAAM,IAAI,eAAe,CACvB,qBAAqB,CAAC,yBAAyB,EAC/C,kDAAkD,GAAG,EAAE,CACxD,CAAC;AACJ,CAAC"}

package/dist/commercial/postVerifyOutcomeBeacon.d.ts

@@ -9,5 +9,7 @@ export declare function postVerifyOutcomeBeacon(input: {
     terminal_status: VerifyOutcomeTerminalStatus;
     workload_class: VerifyOutcomeWorkloadClass;
     subcommand: VerifyOutcomeSubcommand;
+    /** Same value as reserve `x-request-id` for this activation run (optional). */
+    xRequestId?: string;
 }): Promise<void>;
 //# sourceMappingURL=postVerifyOutcomeBeacon.d.ts.map

package/dist/commercial/postVerifyOutcomeBeacon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postVerifyOutcomeBeacon.d.ts","sourceRoot":"","sources":["../../src/commercial/postVerifyOutcomeBeacon.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAChC,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,oBAAoB,CAAC;IAClC,eAAe,EAAE,2BAA2B,CAAC;IAC7C,cAAc,EAAE,0BAA0B,CAAC;IAC3C,UAAU,EAAE,uBAAuB,CAAC;CACrC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChB"}
+{"version":3,"file":"postVerifyOutcomeBeacon.d.ts","sourceRoot":"","sources":["../../src/commercial/postVerifyOutcomeBeacon.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAChC,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,oBAAoB,CAAC;IAClC,eAAe,EAAE,2BAA2B,CAAC;IAC7C,cAAc,EAAE,0BAA0B,CAAC;IAC3C,UAAU,EAAE,uBAAuB,CAAC;IACpC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoChB"}

package/dist/commercial/postVerifyOutcomeBeacon.js

@@ -19,13 +19,17 @@ export async function postVerifyOutcomeBeacon(input) {
         workload_class: input.workload_class,
         subcommand: input.subcommand,
     });
+    const headers = {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+    };
+    if (input.xRequestId?.trim()) {
+        headers["x-request-id"] = input.xRequestId.trim();
+    }
     try {
         await fetchWithTimeout(url, {
             method: "POST",
-            headers: {
-                Authorization: `Bearer ${apiKey}`,
-                "Content-Type": "application/json",
-            },
+            headers,
             body: JSON.stringify(body),
         }, 400);
     }

package/dist/commercial/postVerifyOutcomeBeacon.js.map

@@ -1 +1 @@
-{"version":3,"file":"postVerifyOutcomeBeacon.js","sourceRoot":"","sources":["../../src/commercial/postVerifyOutcomeBeacon.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EACL,8BAA8B,GAI/B,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAM7C;IACC,IAAI,CAAC,yBAAyB,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO;IAE/D,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,GAAG,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,+BAA+B,CAAC;IACtF,MAAM,IAAI,GAAG,8BAA8B,CAAC;QAC1C,MAAM,EAAE,KAAK,CAAC,KAAK;QACnB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,gBAAgB,CACpB,GAAG,EACH;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"postVerifyOutcomeBeacon.js","sourceRoot":"","sources":["../../src/commercial/postVerifyOutcomeBeacon.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EACL,8BAA8B,GAI/B,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAQ7C;IACC,IAAI,CAAC,yBAAyB,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO;IAE/D,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,GAAG,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,+BAA+B,CAAC;IACtF,MAAM,IAAI,GAAG,8BAA8B,CAAC;QAC1C,MAAM,EAAE,KAAK,CAAC,KAAK;QACnB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;IACH,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,MAAM,EAAE;QACjC,cAAc,EAAE,kBAAkB;KACnC,CAAC;IACF,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7B,OAAO,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,gBAAgB,CACpB,GAAG,EACH;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC"}

package/dist/compare.acceptance.test.js

@@ -1,9 +1,12 @@
+import { createHash } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { describe, expect, it } from "vitest";
 import { buildRunComparisonReport } from "./runComparison.js";
+import { buildRegressionArtifactFromDebugCorpus } from "./regressionArtifact.js";
 import { loadSchemaValidator } from "./schemaLoad.js";
+import { stringifyWithSortedKeys } from "./sortedJsonStringify.js";
 import { createEmptyVerificationRunContext } from "./verificationRunContext.js";
 import { finalizeEmittedWorkflowResult } from "./workflowTruthReport.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -48,6 +51,8 @@ function wf(steps, id = "wf_compare_ac") {
 }
 describe("Run comparison acceptance tests", () => {
     const v = loadSchemaValidator("run-comparison-report");
+    const vArtifact = loadSchemaValidator("regression-artifact-v1");
+    const vCert = loadSchemaValidator("outcome-certificate-v1");
     it("AC_9_1_multi_run_compare_emits_schema_v4", () => {
         const r0 = wf([sqlRowStep(0, "t", "a", true)]);
         const r1 = wf([sqlRowStep(0, "t", "a", true)]);
@@ -65,6 +70,26 @@ describe("Run comparison acceptance tests", () => {
         expect(report.compareHighlights.introducedLogicalStepKeys).toContain("sql_row|contacts|id=a");
         expect(report.compareHighlights.resolvedLogicalStepKeys.length).toBeGreaterThanOrEqual(0);
     });
+    it("AC_regression_artifact_narrative_matches_reliability_and_digest_recomputes", () => {
+        const base = join(root, "test", "fixtures", "debug-ui-compare");
+        const r0 = JSON.parse(readFileSync(join(base, "run_a", "workflow-result.json"), "utf8"));
+        const r1 = JSON.parse(readFileSync(join(base, "run_b", "workflow-result.json"), "utf8"));
+        const art = buildRegressionArtifactFromDebugCorpus({
+            results: [r0, r1],
+            runIds: ["run_a", "run_b"],
+            eventPaths: [join(base, "run_a", "events.ndjson"), join(base, "run_b", "events.ndjson")],
+        });
+        expect(vArtifact(art)).toBe(true);
+        expect(art.narrative.classification).toBe(art.verification.reliabilityAssessment.headlineVerdict);
+        expect(art.narrative.headline).toBe(art.verification.reliabilityAssessment.headlineRationale);
+        for (const row of art.outcomeCertificates) {
+            expect(vCert(row.certificate)).toBe(true);
+            const fromCert = createHash("sha256")
+                .update(stringifyWithSortedKeys(row.certificate), "utf8")
+                .digest("hex");
+            expect(fromCert).toBe(row.certificateCanonicalDigest);
+        }
+    });
     it("AC_9_4_headlineVerdict_window_pairwise_divergence", () => {
         const r0 = wf([sqlRowStep(0, "t", "a", true)]);
         const r1 = wf([sqlRowStep(0, "t", "a", false)]);

package/dist/compare.acceptance.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare.acceptance.test.js","sourceRoot":"","sources":["../src/compare.acceptance.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compare.acceptance.test.js","sourceRoot":"","sources":["../src/compare.acceptance.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAEnC,SAAS,UAAU,CACjB,GAAW,EACX,MAAc,EACd,QAAgB,EAChB,QAAiB;IAEjB,OAAO;QACL,GAAG;QACH,MAAM;QACN,cAAc,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACjC,iBAAiB,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;QAC5C,mBAAmB,EAAE;YACnB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YAC/C,cAAc,EAAE,EAAE;SACnB;QACD,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACzC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QACpE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;QAChD,sBAAsB,EAAE,CAAC;QACzB,2BAA2B,EAAE,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,oBAA6B,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,EAAE,CAAC,KAAoB,EAAE,EAAE,GAAG,eAAe;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IACvD,MAAM,MAAM,GAAyB;QACnC,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,EAAE;QACd,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU;QACzC,eAAe,EAAE,EAAE;QACnB,kBAAkB,EAAE;YAClB,eAAe,EAAE,QAAQ;YACzB,oBAAoB,EAAE,CAAC;YACvB,cAAc,EAAE,CAAC;SAClB;QACD,sBAAsB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1C,sBAAsB,EAAE,iCAAiC,EAAE;QAC3D,KAAK;KACN,CAAC;IACF,OAAO,6BAA6B,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,MAAM,CAAC,GAAG,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;IAE5D,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,wBAAwB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,wBAAwB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC9F,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAChE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,MAAM,CAAC,CAAmB,CAAC;QAC3G,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,MAAM,CAAC,CAAmB,CAAC;QAC3G,MAAM,GAAG,GAAG,sCAAsC,CAAC;YACjD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;YACjB,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;YAC1B,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;SACzF,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,GAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAClG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;QAC9F,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,mBAAmB,EAAE,CAAC;YAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;iBAClC,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;iBACxD,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,wBAAwB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnE,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,qDAAqD,CAAC,EAAE,MAAM,CAAC,CAC9B,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAClF,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/compareRunManifest.d.ts

@@ -0,0 +1,32 @@
+export type OutcomeCertificateRunKindForCompare = "contract_sql" | "contract_sql_langgraph_checkpoint_trust";
+export type CertificateProfileV1 = {
+    mode: "uniform";
+    outcomeCertificateRunKind: OutcomeCertificateRunKindForCompare;
+} | {
+    mode: "perRun";
+    entries: Array<{
+        runIndex: number;
+        outcomeCertificateRunKind: OutcomeCertificateRunKindForCompare;
+    }>;
+};
+export type CompareRunManifestEntryV1 = {
+    displayLabel: string;
+    workflowResult: string;
+    events: string;
+};
+export type CompareRunManifestV1 = {
+    schemaVersion: 1;
+    baseDirectory: string;
+    certificateProfile: CertificateProfileV1;
+    runs: CompareRunManifestEntryV1[];
+};
+/**
+ * Read and validate a compare-run manifest. Resolves `baseDirectory` and validates certificate profile
+ * invariants (per-run index coverage) beyond JSON Schema.
+ */
+export declare function loadCompareRunManifest(manifestFilePath: string): {
+    manifest: CompareRunManifestV1;
+    baseDirAbs: string;
+    manifestFileAbs: string;
+};
+//# sourceMappingURL=compareRunManifest.d.ts.map

package/dist/compareRunManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareRunManifest.d.ts","sourceRoot":"","sources":["../src/compareRunManifest.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mCAAmC,GAAG,cAAc,GAAG,yCAAyC,CAAC;AAE7G,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,yBAAyB,EAAE,mCAAmC,CAAC;CAChE,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,yBAAyB,EAAE,mCAAmC,CAAA;KAAE,CAAC,CAAC;CACtG,CAAC;AAEN,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,oBAAoB,CAAC;IACzC,IAAI,EAAE,yBAAyB,EAAE,CAAC;CACnC,CAAC;AAmCF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,GACvB;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CA0BjF"}

package/dist/compareRunManifest.js

@@ -0,0 +1,60 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { CLI_OPERATIONAL_CODES } from "./cliOperationalCodes.js";
+import { loadSchemaValidator } from "./schemaLoad.js";
+import { TruthLayerError } from "./truthLayerError.js";
+function validateProfileAgainstRuns(m, baseDir) {
+    const n = m.runs.length;
+    if (m.certificateProfile.mode === "perRun") {
+        const e = m.certificateProfile.entries;
+        if (e.length !== n) {
+            throw new TruthLayerError(CLI_OPERATIONAL_CODES.COMPARE_MANIFEST_SCHEMA_INVALID, `certificateProfile.entries.length (${e.length}) must equal runs.length (${n})`);
+        }
+        const want = new Set(Array.from({ length: n }, (_, i) => i));
+        const got = new Set();
+        for (const ent of e) {
+            if (got.has(ent.runIndex)) {
+                throw new TruthLayerError(CLI_OPERATIONAL_CODES.COMPARE_MANIFEST_SCHEMA_INVALID, `duplicate runIndex ${ent.runIndex} in certificateProfile.entries`);
+            }
+            got.add(ent.runIndex);
+        }
+        if (got.size !== n || ![...got].every((i) => want.has(i))) {
+            throw new TruthLayerError(CLI_OPERATIONAL_CODES.COMPARE_MANIFEST_SCHEMA_INVALID, `certificateProfile.entries must list runIndex 0..${n - 1} exactly once each`);
+        }
+    }
+}
+/**
+ * Read and validate a compare-run manifest. Resolves `baseDirectory` and validates certificate profile
+ * invariants (per-run index coverage) beyond JSON Schema.
+ */
+export function loadCompareRunManifest(manifestFilePath) {
+    const manifestFileAbs = path.resolve(manifestFilePath);
+    let raw;
+    try {
+        raw = readFileSync(manifestFileAbs, "utf8");
+    }
+    catch (e) {
+        if (e instanceof TruthLayerError)
+            throw e;
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new TruthLayerError(CLI_OPERATIONAL_CODES.COMPARE_MANIFEST_READ_FAILED, msg);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new TruthLayerError(CLI_OPERATIONAL_CODES.COMPARE_INPUT_JSON_SYNTAX, msg);
+    }
+    const v = loadSchemaValidator("compare-run-manifest-v1");
+    if (!v(parsed)) {
+        const detail = JSON.stringify(v.errors ?? []);
+        throw new TruthLayerError(CLI_OPERATIONAL_CODES.COMPARE_MANIFEST_SCHEMA_INVALID, detail);
+    }
+    const m = parsed;
+    validateProfileAgainstRuns(m, manifestFileAbs);
+    const baseDirAbs = path.resolve(path.dirname(manifestFileAbs), m.baseDirectory);
+    return { manifest: m, baseDirAbs, manifestFileAbs };
+}
+//# sourceMappingURL=compareRunManifest.js.map

package/dist/compareRunManifest.js.map

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

package/dist/debug-ui/app.css

@@ -16,6 +16,22 @@ header h1 {
   margin: 0 0 1rem;
   max-width: 52rem;
 }
+.cli-hint {
+  color: #c9d1d9;
+  margin: 0 0 1rem;
+  max-width: 52rem;
+  font-size: 0.95rem;
+}
+.cli-hint code {
+  display: block;
+  margin-top: 0.35rem;
+  padding: 0.45rem 0.6rem;
+  background: #161b22;
+  border: 1px solid #30363d;
+  border-radius: 6px;
+  color: #79c0ff;
+  font-size: 0.85rem;
+}
 .tabs {
   display: flex;
   gap: 0.5rem;
@@ -171,6 +187,32 @@ tr.selected {
   border-color: #f0883e;
   background: #2d1f12;
 }
+@keyframes tracePulseFocus {
+  0% {
+    box-shadow: 0 0 0 0 rgba(240, 136, 62, 0.55);
+  }
+  70% {
+    box-shadow: 0 0 0 10px rgba(240, 136, 62, 0);
+  }
+  100% {
+    box-shadow: 0 0 0 0 rgba(240, 136, 62, 0);
+  }
+}
+.trace-step.pulse-focus {
+  animation: tracePulseFocus 0.85s ease-out 1;
+}
+.focus-target-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  margin-top: 0.5rem;
+}
+.focus-target-btn {
+  text-align: left;
+  max-width: 100%;
+  font-size: 0.8rem;
+  line-height: 1.3;
+}
 button {
   cursor: pointer;
   background: #21262d;