agentskeptic 0.2.0 → 1.0.0

package/schemas/outcome-certificate-v1.schema.json

@@ -0,0 +1,66 @@
+{
+  "$id": "https://agentskeptic.com/schemas/outcome-certificate-v1.schema.json",
+  "title": "OutcomeCertificateV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "workflowId",
+    "runKind",
+    "stateRelation",
+    "highStakesReliance",
+    "relianceRationale",
+    "intentSummary",
+    "explanation",
+    "steps",
+    "humanReport"
+  ],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "workflowId": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "runKind": { "type": "string", "enum": ["contract_sql", "quick_preview"] },
+    "stateRelation": {
+      "type": "string",
+      "enum": ["matches_expectations", "does_not_match", "not_established"]
+    },
+    "highStakesReliance": { "type": "string", "enum": ["permitted", "prohibited"] },
+    "relianceRationale": { "type": "string", "minLength": 1, "maxLength": 8192 },
+    "intentSummary": { "type": "string", "minLength": 1, "maxLength": 8192 },
+    "explanation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["headline", "details"],
+      "properties": {
+        "headline": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "details": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["code", "message"],
+            "properties": {
+              "code": { "type": "string", "minLength": 1, "maxLength": 256 },
+              "message": { "type": "string", "minLength": 1, "maxLength": 4096 }
+            }
+          }
+        }
+      }
+    },
+    "steps": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["seq", "declaredAction", "expectedOutcome", "observedOutcome"],
+        "properties": {
+          "seq": { "type": "integer", "minimum": 0 },
+          "toolId": { "type": "string", "maxLength": 512 },
+          "declaredAction": { "type": "string", "minLength": 1, "maxLength": 4096 },
+          "expectedOutcome": { "type": "string", "minLength": 1, "maxLength": 4096 },
+          "observedOutcome": { "type": "string", "minLength": 1, "maxLength": 8192 }
+        }
+      }
+    },
+    "humanReport": { "type": "string", "minLength": 1, "maxLength": 1048576 }
+  }
+}

package/schemas/public-verification-report-v2.schema.json

@@ -0,0 +1,15 @@
+{
+  "$id": "https://agentskeptic.com/schemas/public-verification-report-v2.schema.json",
+  "title": "PublicVerificationReportEnvelopeV2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "certificate"],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 2 },
+    "certificate": {
+      "$ref": "https://agentskeptic.com/schemas/outcome-certificate-v1.schema.json"
+    },
+    "cliVersion": { "type": "string", "maxLength": 128 },
+    "createdFrom": { "type": "string", "maxLength": 256 }
+  }
+}

package/scripts/discovery-payload.lib.cjs

@@ -27,6 +27,21 @@ const MAX_SUMMARY_UTF8_BYTES = 65536;
 const MAX_PR_BODY_UTF8_BYTES = 10240;
 const STDERR_TAIL_LINES = 20;
 
+const REPO_ROOT = join(__dirname, "..");
+const README_ADOPTION_START = "<!-- adoption-canonical:start -->";
+const README_ADOPTION_END = "<!-- adoption-canonical:end -->";
+
+function extractReadmeAdoptionExcerptForLlms() {
+  const readme = readFileSync(join(REPO_ROOT, "README.md"), "utf8");
+  const i = readme.indexOf(README_ADOPTION_START);
+  const j = readme.indexOf(README_ADOPTION_END);
+  if (i < 0 || j < 0 || j <= i) return "";
+  return readme
+    .slice(i + README_ADOPTION_START.length, j)
+    .replace(/^\r?\n/, "")
+    .replace(/\r?\n$/, "");
+}
+
 /**
  * @param {string} gitRepositoryUrl
  * @returns {{ owner: string, repo: string }}
@@ -180,11 +195,22 @@ function renderLlmsTextFromPayload(payload) {
   const integrateUrl = links.integrate;
   const learnHubUrl = links.learnHub;
   const openapiSelfCanonical = links.openapiCanonical;
+  const adoptionExcerpt = extractReadmeAdoptionExcerptForLlms();
+  const adoptionLlmsBlock =
+    adoptionExcerpt.length > 0
+      ? [
+          "<!-- adoption-canonical-llms:start -->",
+          adoptionExcerpt,
+          "<!-- adoption-canonical-llms:end -->",
+          String(payload.identityOneLiner),
+        ].join("\n")
+      : String(payload.identityOneLiner);
   const lines = [
     "# AgentSkeptic",
     "",
     "## Summary",
-    String(payload.identityOneLiner),
+    "",
+    adoptionLlmsBlock,
     "",
     "## Primary links",
     `- Canonical site: ${links.site}`,