agentskeptic 3.1.0 → 3.3.0

package/README.md

@@ -336,6 +336,12 @@ Everything beyond core contract verification lives in **[`docs/agentskeptic.md`]
 
 ## Commercial CLI (npm) vs OSS (this repo)
 
+<!-- codegen:buyer-truth:start:COMMERCIAL_ENTRY -->
+**Commercial metering (published npm)** uses `AGENTSKEPTIC_API_KEY` + `POST /api/v1/usage/reserve` as documented in docs/commercial.md — account-pooled quota per billing month.
+
+**OSS/unmetered CLI** for single-run verification: clone this repo and use the OSS build (`WF_BUILD_PROFILE=oss` / default `npm run build` artifact). State over-time `enforce` needs the commercial CLI and a paid entitlement.
+<!-- codegen:buyer-truth:end:COMMERCIAL_ENTRY -->
+
 Canonical write-up: **[`docs/commercial.md`](docs/commercial.md)** (npm package, Stripe, keys, telemetry, validation, entitlements; operator metrics in **[`docs/funnel-observability.md`](docs/funnel-observability.md)**—disable with **`AGENTSKEPTIC_TELEMETRY=0`**). OSS builds in this repo run contract **`verify`** / **`quick`** without a license server for stateless runs. Stateful `agentskeptic enforce` and over-time guarantees require a commercial build per **[`docs/commercial-enforce-gate-normative.md`](docs/commercial-enforce-gate-normative.md)**. Example workflow: **[`examples/github-actions/agentskeptic-commercial.yml`](examples/github-actions/agentskeptic-commercial.yml)**.
 
 ## Status, contributing, security

package/config/marketing.json

@@ -49,9 +49,6 @@
     "{{INTEGRATE_URL}}",
     "{{ORIGIN}}/"
   ],
-  "r2": {
-    "frameworkMaturity": "CrewAI: full support. AutoGen: experimental. Works with any framework that can emit structured activity."
-  },
   "site": {
     "integrate": {
       "title": "Get started",
@@ -86,12 +83,7 @@
   "integratePage": {
     "packLedCommand": "npx agentskeptic init --framework none --database sqlite --yes\n\n# Pack-led replay (after scaffold):\nnpx agentskeptic crossing \\\n  --workflow-id YOUR_WORKFLOW_ID \\\n  --events ./path/to/events.ndjson \\\n  --registry ./path/to/tools.json \\\n  --db ./path/to/readable.sqlite",
     "githubDeepLink": "https://github.com/jwekavanagh/agentskeptic/blob/main/docs/integrate.md",
-    "githubFirstRunLink": "https://github.com/jwekavanagh/agentskeptic/blob/main/docs/integrate.md",
-    "requirements": [
-      "Node.js 22 or newer",
-      "Read-only access to at least one queryable store (SQL, vectors, S3, Mongo, HTTP, etc.)",
-      "Ability to emit or export structured tool activity as NDJSON"
-    ]
+    "githubFirstRunLink": "https://github.com/jwekavanagh/agentskeptic/blob/main/docs/integrate.md"
   },
   "briefProblem": "Claims vs read-only; ROW_ABSENT.",
   "briefSections": [],

package/dist/publicDistribution.generated.d.ts

@@ -1,5 +1,5 @@
 export declare const PUBLIC_DISTRIBUTION_SSOT_BLOB_URL = "https://github.com/jwekavanagh/agentskeptic/blob/main/docs/public-distribution.md";
 export declare const PUBLIC_CANONICAL_SITE_ORIGIN = "https://agentskeptic.com";
-export declare const AGENTSKEPTIC_CLI_SEMVER = "3.1.0";
+export declare const AGENTSKEPTIC_CLI_SEMVER = "3.3.0";
 export declare function formatDistributionFooter(): string;
 //# sourceMappingURL=publicDistribution.generated.d.ts.map

package/dist/publicDistribution.generated.js

@@ -1,7 +1,7 @@
 // Generated by npm run emit-primary-marketing — do not hand edit.
 export const PUBLIC_DISTRIBUTION_SSOT_BLOB_URL = "https://github.com/jwekavanagh/agentskeptic/blob/main/docs/public-distribution.md";
 export const PUBLIC_CANONICAL_SITE_ORIGIN = "https://agentskeptic.com";
-export const AGENTSKEPTIC_CLI_SEMVER = "3.1.0";
+export const AGENTSKEPTIC_CLI_SEMVER = "3.3.0";
 export function formatDistributionFooter() {
     return "Context: https://agentskeptic.com/database-truth-vs-traces\n"
         + "https://agentskeptic.com/integrate\n"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentskeptic",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "description": "AgentSkeptic compares agent claims with real downstream state — databases, APIs, object stores, and vector stores — and returns a clear verdict.",
   "license": "MIT",
   "type": "module",
@@ -72,6 +72,9 @@
     "sync-integrator-docs-embedded": "node scripts/sync-integrator-docs-embedded.mjs",
     "sync-epistemic-contract-website": "node scripts/sync-epistemic-contract-website.mjs",
     "check:epistemic-contract-structure": "node scripts/validate-epistemic-contract-structure.mjs",
+    "codegen:buyer-truth": "npm run codegen:buyer-truth -w agentskeptic-web",
+    "validate:buyer-truth-schema": "node scripts/validate-buyer-truth-schema.mjs",
+    "check:buyer-truth": "node scripts/check-buyer-truth.mjs",
     "check:partner-quickstart": "node scripts/check-partner-quickstart.mjs",
     "partner-quickstart": "node scripts/partner-quickstart-verify.mjs",
     "first-run-verify": "node scripts/partner-quickstart-verify.mjs",

package/schemas/buyer-truth-v1.schema.json

@@ -0,0 +1,162 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentskeptic.dev/schemas/buyer-truth-v1.schema.json",
+  "title": "BuyerTruthV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "projectionVersion",
+    "quota",
+    "frameworkClaims",
+    "frameworkFootnoteSuffix",
+    "verificationPaths",
+    "integrateRequirements",
+    "commercialEntryPoints",
+    "pricing",
+    "accountQuotaUrgency",
+    "securityQuickFactsBullets",
+    "canonicalHref",
+    "readmeSegments",
+    "homepageCopy"
+  ],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "projectionVersion": { "type": "integer", "minimum": 1 },
+    "quota": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["model", "pooledExplanation"],
+      "properties": {
+        "model": { "type": "string", "const": "account_pooled" },
+        "pooledExplanation": { "type": "string", "minLength": 8 }
+      }
+    },
+    "frameworkClaims": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "displayName", "status"],
+        "properties": {
+          "id": { "type": "string" },
+          "displayName": { "type": "string" },
+          "status": {
+            "type": "string",
+            "enum": ["supported", "removed", "experimental"]
+          }
+        }
+      }
+    },
+    "frameworkFootnoteSuffix": { "type": "string" },
+    "verificationPaths": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["quickSqlOnlyDisclaimer", "mechanismCalloutAppend"],
+      "properties": {
+        "quickSqlOnlyDisclaimer": { "type": "string" },
+        "mechanismCalloutAppend": { "type": "string" }
+      }
+    },
+    "integrateRequirements": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1
+    },
+    "commercialEntryPoints": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["homeCommercialLeadMarkdown"],
+      "properties": {
+        "homeCommercialLeadMarkdown": { "type": "string" }
+      }
+    },
+    "pricing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "pricingHeroSubtitleTemplate",
+        "pricingHeroSubtitleSecondary",
+        "paidVerificationTemplate",
+        "enforcementMarkdown",
+        "contractsMarkdown",
+        "localVerificationFootnote",
+        "comparisonRows"
+      ],
+      "properties": {
+        "pricingHeroSubtitleTemplate": { "type": "string" },
+        "pricingHeroSubtitleSecondary": { "type": "string" },
+        "paidVerificationTemplate": { "type": "string" },
+        "enforcementMarkdown": { "type": "string" },
+        "contractsMarkdown": { "type": "string" },
+        "localVerificationFootnote": { "type": "string" },
+        "comparisonRows": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["featureKey", "featureDisplay", "cells"],
+            "properties": {
+              "featureKey": { "type": "string" },
+              "featureDisplay": { "type": "string" },
+              "cells": {
+                "type": "object",
+                "additionalProperties": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "accountQuotaUrgency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "notice", "warning", "in_overage", "at_cap", "zero_usage"],
+      "properties": {
+        "ok": { "type": "string" },
+        "notice": { "type": "string" },
+        "warning": { "type": "string" },
+        "in_overage": { "type": "string" },
+        "at_cap": { "type": "string" },
+        "zero_usage": { "type": "string" }
+      }
+    },
+    "securityQuickFactsBullets": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 4,
+      "maxItems": 4
+    },
+    "canonicalHref": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["verificationSemantics", "commercialSsotDoc", "commercialBoundary"],
+      "properties": {
+        "verificationSemantics": { "type": "string", "pattern": "^https://" },
+        "commercialSsotDoc": { "type": "string", "pattern": "^https://" },
+        "commercialBoundary": { "type": "string", "pattern": "^https://" }
+      }
+    },
+    "readmeSegments": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["commercialEntry"],
+      "properties": {
+        "commercialEntry": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1
+        }
+      }
+    },
+    "homepageCopy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["valueProposition", "mechanismWorksWith"],
+      "properties": {
+        "valueProposition": { "type": "string" },
+        "mechanismWorksWith": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/ci/verification-truth.manifest.json

@@ -12,6 +12,8 @@
   },
   "gating": {
     "gitPathspecs": [
+      "config/buyer-truth.v1.json",
+      "schemas/buyer-truth-v1.schema.json",
       "schemas/",
       "llms.txt",
       "README.md",

package/schemas/openapi-commercial-v1.yaml

@@ -1,7 +1,7 @@
 openapi: "3.0.3"
 info:
   title: AgentSkeptic commercial license API
-  version: "3.1.0"
+  version: "3.3.0"
   contact:
     url: https://agentskeptic.com
   x-agentskeptic-distribution:

package/scripts/validate-marketing.cjs

@@ -70,7 +70,6 @@ function validateMarketingValue(m) {
     "readmeFold",
     "shareableTerminalDemo",
     "cliFollowupLines",
-    "r2",
     "site",
     "integratePage",
     "problemIndex",
@@ -81,6 +80,11 @@ function validateMarketingValue(m) {
       throw new Error(`marketing: missing required key ${k}`);
     }
   }
+  if ("r2" in m) {
+    throw new Error(
+      "marketing: top-level key r2 removed — homepage framework footer is driven by config/buyer-truth.v1.json",
+    );
+  }
   if (!Array.isArray(m.keywords) || m.keywords.length === 0) {
     throw new Error("marketing: keywords must be a non-empty array");
   }
@@ -116,11 +120,10 @@ function validateMarketingValue(m) {
   if (!cmd.includes("tools.json")) {
     throw new Error("marketing: packLedCommand must reference tools.json");
   }
-  if (!Array.isArray(m.integratePage.requirements) || m.integratePage.requirements.length < 1) {
-    throw new Error("marketing: integratePage.requirements must be a non-empty array");
-  }
-  if (m.integratePage.requirements.length < 1 || m.integratePage.requirements.length > 5) {
-    throw new Error("marketing: integratePage.requirements must have 1–5 items");
+  if ("requirements" in m.integratePage) {
+    throw new Error(
+      "marketing: integratePage.requirements removed — use Buyer Truth integrateRequirements (/integrate page)",
+    );
   }
   const v = String(m.visitorProblemAnswer);
   if (v.toLowerCase().includes("causality")) {