agentskeptic 1.0.0 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentskeptic",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Traces say success while rows are missing or wrong. AgentSkeptic runs read-only SQL at verification time on Postgres or SQLite—ground truth from structured tool activity, not trace color alone.",
   "license": "MIT",
   "type": "module",
@@ -27,13 +27,13 @@
     "dev": "npm run dev -w agentskeptic-web",
     "test:vitest": "vitest run",
     "verify:decision-readiness": "npm run test:vitest -w agentskeptic-web -- __tests__/githubHeadingSlug.contract.test.ts __tests__/integrateActivationNorthStar.contract.test.ts __tests__/integrate-page-completion-semantics.contract.test.tsx __tests__/growth-metrics-ssot.contract.test.ts __tests__/repo-reference-integrity.growth-observability.test.ts",
-    "test:node:sqlite": "node scripts/assert-dependency-security-pins.mjs && node scripts/assert-no-legacy-verify-surface.mjs && node --test --test-force-exit test/reconciler.sqlite.test.mjs test/pipeline.sqlite.test.mjs test/withWorkflowVerification.test.mjs test/workflowTruthReport.test.mjs test/cli.test.mjs test/post-product-activation-install-id.test.mjs test/workflow-lineage-classify.test.mjs test/resolve-telemetry-source.test.mjs test/github-workflows-agentskeptic-telemetry-env.test.mjs test/maybe-emit-oss-claim-telemetry-off.test.mjs test/first-run-verify-output.integration.test.mjs test/stable-failure-consistency.test.mjs test/workflow-result-consumer-contract.test.mjs test/workflow-result-stdout-version.test.mjs test/docs-relational-ssot.test.mjs test/tools-registry-relational-surface.test.mjs test/docs-contract.test.mjs test/docs-commercial-enforce-gate-normative.test.mjs test/docs-remediation-doctrine.test.mjs test/bundle-signature-fixture.test.mjs test/bundle-signature-codes-doc.test.mjs test/bundle-signature-cli-write.test.mjs test/quick-verify.sqlite.test.mjs test/bootstrap-pack.test.mjs test/crossing-cli.test.mjs test/quickVerifyPostbuildGate.test.mjs test/npm-scripts-contract.test.mjs test/langgraph-reference-emitter-before-cli-spawn.test.mjs test/removed-script-names-ban.test.mjs test/docs-workflow-result-normative-prose.test.mjs test/enforce-oss-forbidden.test.mjs test/oss-output-lock-batch.test.mjs test/lock-success-monetized-footer.integration.test.mjs test/docs-enforce-stream-contract.test.mjs test/docs-quick-enforce-link.test.mjs test/commercial-pricing-policy-parity.test.mjs test/discovery-payload.test.mjs test/redaction-rules.test.mjs test/indexable-guide-paths-fs.contract.test.mjs test/npm-pack-discovery-scripts.test.mjs test/registry-metadata-parity.test.mjs test/docs-related-exists-export-ssot-negative.mjs test/quick-param-pointer.gates.test.mjs test/dependency-security-pins.schema.contract.test.mjs test/drizzle-identifier-safety.contract.test.mjs test/assert-destructive-postgres-urls.test.mjs test/readme-wedge-inevitability.test.mjs test/adoption-complete-surface-parity.test.mjs test/adoption-epistemics-contract.test.mjs test/integrate-spine-contract.test.mjs test/integrate-spine-ssot-fixtures.test.mjs test/integrate-route-copy-absence.test.mjs test/adoption-validation-registry.test.mjs test/decision-ready-surfaces-manifest.test.mjs test/oss-legacy-handoff-ban.test.mjs test/sync-adoption-canonical-to-llms.test.mjs test/verify-agentskeptic-consumer.e2e.test.mjs",
-    "test:postgres": "node scripts/pg-ci-init.mjs && node --test --test-force-exit test/postgres-session-readonly.test.mjs test/postgres-privilege.test.mjs test/pipeline.postgres.test.mjs test/ci-workflow-truth-postgres-contract.test.mjs test/quick-verify.postgres.test.mjs",
+    "test:node:sqlite": "node scripts/assert-dependency-security-pins.mjs && node scripts/assert-no-legacy-verify-surface.mjs && node scripts/assert-no-withWorkflowVerification-surface.mjs && node --test --test-force-exit test/reconciler.sqlite.test.mjs test/pipeline.sqlite.test.mjs test/decisionGate.test.mjs test/workflowTruthReport.test.mjs test/cli.test.mjs test/post-product-activation-install-id.test.mjs test/workflow-lineage-classify.test.mjs test/resolve-telemetry-source.test.mjs test/github-workflows-agentskeptic-telemetry-env.test.mjs test/maybe-emit-oss-claim-telemetry-off.test.mjs test/first-run-verify-output.integration.test.mjs test/stable-failure-consistency.test.mjs test/workflow-result-consumer-contract.test.mjs test/workflow-result-stdout-version.test.mjs test/docs-relational-ssot.test.mjs test/tools-registry-relational-surface.test.mjs test/docs-contract.test.mjs test/docs-commercial-enforce-gate-normative.test.mjs test/docs-remediation-doctrine.test.mjs test/bundle-signature-fixture.test.mjs test/bundle-signature-codes-doc.test.mjs test/bundle-signature-cli-write.test.mjs test/quick-verify.sqlite.test.mjs test/bootstrap-pack.test.mjs test/crossing-cli.test.mjs test/quickVerifyPostbuildGate.test.mjs test/npm-scripts-contract.test.mjs test/langgraph-reference-emitter-before-cli-spawn.test.mjs test/langgraph-checkpoint-trust-terminal.contract.test.mjs test/langgraph-ineligible-certificate.import-guard.test.mjs test/removed-script-names-ban.test.mjs test/docs-workflow-result-normative-prose.test.mjs test/enforce-oss-forbidden.test.mjs test/oss-output-lock-batch.test.mjs test/lock-success-monetized-footer.integration.test.mjs test/docs-enforce-stream-contract.test.mjs test/docs-quick-enforce-link.test.mjs test/commercial-pricing-policy-parity.test.mjs test/discovery-payload.test.mjs test/redaction-rules.test.mjs test/indexable-guide-paths-fs.contract.test.mjs test/npm-pack-discovery-scripts.test.mjs test/registry-metadata-parity.test.mjs test/docs-related-exists-export-ssot-negative.mjs test/quick-param-pointer.gates.test.mjs test/dependency-security-pins.schema.contract.test.mjs test/drizzle-identifier-safety.contract.test.mjs test/assert-destructive-postgres-urls.test.mjs test/readme-wedge-inevitability.test.mjs test/adoption-complete-surface-parity.test.mjs test/adoption-epistemics-contract.test.mjs test/integrate-spine-contract.test.mjs test/integrate-spine-ssot-fixtures.test.mjs test/integrate-route-copy-absence.test.mjs test/adoption-validation-registry.test.mjs test/decision-ready-surfaces-manifest.test.mjs test/oss-legacy-handoff-ban.test.mjs test/sync-adoption-canonical-to-llms.test.mjs test/verify-agentskeptic-consumer.e2e.test.mjs",
+    "test:postgres": "node scripts/pg-ci-init.mjs && node --test --test-force-exit test/postgres-session-readonly.test.mjs test/postgres-privilege.test.mjs test/pipeline.postgres.test.mjs test/decisionGate.postgres.test.mjs test/ci-workflow-truth-postgres-contract.test.mjs test/quick-verify.postgres.test.mjs",
     "test:workflow-truth-contract": "node --test --test-force-exit test/ci-workflow-truth-postgres-contract.test.mjs",
     "validate-ttfv": "node scripts/validate-ttfv.mjs",
-    "test": "npm run build && npm run check:epistemic-contract-structure && npm run test:vitest && npm run test:vitest -w agentskeptic-web -- __tests__/langgraph-reference-primacy.dom.test.tsx __tests__/oss-claim-client-flow.dom.test.tsx __tests__/integrate-page-completion-semantics.contract.test.tsx && npm run test:node:sqlite && node scripts/first-run.mjs && node scripts/validate-adoption-complete.mjs && node --test test/validate-adoption-complete-failure.test.mjs && node scripts/validate-adoption-complete.mjs && npm run partner-quickstart && node scripts/validate-integrate-spine.mjs && node scripts/validate-integrator-onboarding-shape.mjs && node scripts/langgraph-reference-verify.mjs && node test/partner-quickstart.adversarial.mjs && npm run check:partner-quickstart-ssot && node dist/cli.js assurance run --manifest examples/assurance/manifest.json && node scripts/commercial-enforce-test-harness.mjs && npm run build && npm run validate-ttfv && node scripts/related-exists-export-user-outcome.mjs",
+    "test": "npm run build && npm run check:epistemic-contract-structure && npm run test:vitest && npm run test:vitest -w agentskeptic-web -- __tests__/langgraph-reference-primacy.dom.test.tsx __tests__/oss-claim-client-flow.dom.test.tsx __tests__/integrate-page-completion-semantics.contract.test.tsx && npm run test:node:sqlite && node scripts/first-run.mjs && node scripts/validate-adoption-complete.mjs && node --test test/validate-adoption-complete-failure.test.mjs && node scripts/validate-adoption-complete.mjs && npm run partner-quickstart && node scripts/validate-integrate-spine.mjs && node scripts/validate-integrator-onboarding-shape.mjs && node scripts/langgraph-reference-verify.mjs && node scripts/assert-no-langgraph-v1-product-path.mjs && node test/partner-quickstart.adversarial.mjs && npm run check:partner-quickstart-ssot && node dist/cli.js assurance run --manifest examples/assurance/manifest.json && node scripts/commercial-enforce-test-harness.mjs && npm run build && npm run validate-ttfv && node scripts/related-exists-export-user-outcome.mjs",
     "test:debug-ui": "playwright test",
-    "test:ci": "npm run build && npm run check:epistemic-contract-structure && npm run test:vitest && npm run test:vitest -w agentskeptic-web -- __tests__/langgraph-reference-primacy.dom.test.tsx __tests__/oss-claim-client-flow.dom.test.tsx __tests__/integrate-page-completion-semantics.contract.test.tsx && npm run test:node:sqlite && node scripts/first-run.mjs && node scripts/validate-adoption-complete.mjs && node --test test/validate-adoption-complete-failure.test.mjs && node scripts/validate-adoption-complete.mjs && npm run partner-quickstart && node scripts/validate-integrate-spine.mjs && node scripts/validate-integrator-onboarding-shape.mjs && node scripts/langgraph-reference-verify.mjs && node test/partner-quickstart.adversarial.mjs && npm run check:partner-quickstart-ssot && node dist/cli.js assurance run --manifest examples/assurance/manifest.json && npm run test:postgres && node scripts/run-partner-quickstart-postgres-ci.mjs && node scripts/commercial-enforce-test-harness.mjs --require-postgres && npx playwright install chromium && npm run test:debug-ui && npm run build && npm run validate-ttfv && node scripts/related-exists-export-user-outcome.mjs",
+    "test:ci": "npm run build && npm run check:epistemic-contract-structure && npm run test:vitest && npm run test:vitest -w agentskeptic-web -- __tests__/langgraph-reference-primacy.dom.test.tsx __tests__/oss-claim-client-flow.dom.test.tsx __tests__/integrate-page-completion-semantics.contract.test.tsx && npm run test:node:sqlite && node scripts/first-run.mjs && node scripts/validate-adoption-complete.mjs && node --test test/validate-adoption-complete-failure.test.mjs && node scripts/validate-adoption-complete.mjs && npm run partner-quickstart && node scripts/validate-integrate-spine.mjs && node scripts/validate-integrator-onboarding-shape.mjs && node scripts/langgraph-reference-verify.mjs && node scripts/assert-no-langgraph-v1-product-path.mjs && node test/partner-quickstart.adversarial.mjs && npm run check:partner-quickstart-ssot && node dist/cli.js assurance run --manifest examples/assurance/manifest.json && npm run test:postgres && node scripts/run-partner-quickstart-postgres-ci.mjs && node scripts/commercial-enforce-test-harness.mjs --require-postgres && npx playwright install chromium && npm run test:debug-ui && npm run build && npm run validate-ttfv && node scripts/related-exists-export-user-outcome.mjs",
     "example:workflow-hook": "npm run build && node examples/workflow-runner.mjs",
     "agentskeptic": "node dist/cli.js",
     "migrate:workflow-result-v11": "npm run build && node scripts/migrate-workflow-result-v11.mjs",

package/schemas/event.schema.json

@@ -32,6 +32,41 @@
         "timestamp": { "type": "string" }
       }
     },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "workflowId",
+        "runEventId",
+        "type",
+        "seq",
+        "toolId",
+        "params",
+        "langgraphCheckpoint"
+      ],
+      "properties": {
+        "schemaVersion": { "const": 3 },
+        "workflowId": { "type": "string", "minLength": 1 },
+        "runEventId": { "type": "string", "minLength": 1 },
+        "parentRunEventId": { "type": "string", "minLength": 1 },
+        "type": { "const": "tool_observed" },
+        "seq": { "type": "integer", "minimum": 0 },
+        "toolId": { "type": "string", "minLength": 1 },
+        "params": { "type": "object" },
+        "timestamp": { "type": "string" },
+        "langgraphCheckpoint": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["threadId", "checkpointNs", "checkpointId"],
+          "properties": {
+            "threadId": { "type": "string", "minLength": 1 },
+            "checkpointNs": { "type": "string" },
+            "checkpointId": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
     {
       "type": "object",
       "additionalProperties": false,

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

@@ -18,7 +18,10 @@
   "properties": {
     "schemaVersion": { "type": "integer", "const": 1 },
     "workflowId": { "type": "string", "minLength": 1, "maxLength": 512 },
-    "runKind": { "type": "string", "enum": ["contract_sql", "quick_preview"] },
+    "runKind": {
+      "type": "string",
+      "enum": ["contract_sql", "contract_sql_langgraph_checkpoint_trust", "quick_preview"]
+    },
     "stateRelation": {
       "type": "string",
       "enum": ["matches_expectations", "does_not_match", "not_established"]
@@ -61,6 +64,26 @@
         }
       }
     },
-    "humanReport": { "type": "string", "minLength": 1, "maxLength": 1048576 }
+    "humanReport": { "type": "string", "minLength": 1, "maxLength": 1048576 },
+    "checkpointVerdicts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["checkpointKey", "verdict", "seqs", "productionMeaning"],
+        "properties": {
+          "checkpointKey": { "type": "string", "minLength": 1, "maxLength": 2048 },
+          "verdict": {
+            "type": "string",
+            "enum": ["verified", "inconsistent", "incomplete"]
+          },
+          "seqs": {
+            "type": "array",
+            "items": { "type": "integer", "minimum": 0 }
+          },
+          "productionMeaning": { "type": "string", "minLength": 1, "maxLength": 8192 }
+        }
+      }
+    }
   }
 }

package/schemas/workflow-engine-result.schema.json

@@ -81,7 +81,7 @@
         "lastRunEvent"
       ],
       "properties": {
-        "maxWireSchemaVersion": { "type": "integer", "enum": [1, 2] },
+        "maxWireSchemaVersion": { "type": "integer", "enum": [1, 2, 3] },
         "retrievalEvents": {
           "type": "array",
           "items": {
@@ -502,6 +502,7 @@
             },
             "repeatObservationCount": { "type": "integer", "minimum": 1 },
             "evaluatedObservationOrdinal": { "type": "integer", "minimum": 1 },
+            "langgraphCheckpointKey": { "type": "string", "minLength": 1 },
             "failureDiagnostic": {
               "type": "string",
               "enum": [

package/scripts/discovery-acquisition.lib.cjs

@@ -1,6 +1,6 @@
 "use strict";
 
-const { readFileSync } = require("node:fs");
+const { existsSync, readFileSync, readdirSync } = require("node:fs");
 const { join } = require("node:path");
 const Ajv = require("ajv");
 const addFormats = require("ajv-formats");
@@ -33,6 +33,36 @@ function loadDiscoveryAcquisition(root) {
   return JSON.parse(readFileSync(jsonPath, "utf8"));
 }
 
+/**
+ * @param {string} root
+ * @returns {{ guides: string[]; examples: string[]; compare: string[] }}
+ */
+function listMarkdownSurfaceRoutesGrouped(root) {
+  const base = join(root, "website", "content", "surfaces");
+  /** @type {{ guides: string[]; examples: string[]; compare: string[] }} */
+  const out = { guides: [], examples: [], compare: [] };
+  for (const seg of /** @type {const} */ (["guides", "examples", "compare"])) {
+    const dir = join(base, seg);
+    if (!existsSync(dir)) continue;
+    for (const f of readdirSync(dir)) {
+      if (!f.endsWith(".md")) continue;
+      const raw = readFileSync(join(dir, f), "utf8");
+      const m = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+      if (!m) throw new Error(`markdown-surfaces: missing frontmatter in ${seg}/${f}`);
+      const rm = m[1].match(/^route:\s*(.+)$/m);
+      if (!rm) throw new Error(`markdown-surfaces: missing route in ${seg}/${f}`);
+      const route = rm[1].trim().replace(/^['"]|['"]$/g, "");
+      if (seg === "guides") out.guides.push(route);
+      else if (seg === "examples") out.examples.push(route);
+      else out.compare.push(route);
+    }
+  }
+  out.guides.sort((a, b) => a.localeCompare(b, "en", { sensitivity: "base" }));
+  out.examples.sort((a, b) => a.localeCompare(b, "en", { sensitivity: "base" }));
+  out.compare.sort((a, b) => a.localeCompare(b, "en", { sensitivity: "base" }));
+  return out;
+}
+
 /**
  * @param {Record<string, unknown>} discovery
  * @param {string} originNormalized
@@ -85,71 +115,6 @@ function escapeMdLinkText(s) {
   return s.replace(/\\/g, "\\\\").replace(/\[/g, "\\[").replace(/\]/g, "\\]");
 }
 
-/**
- * @param {Record<string, unknown>} discovery
- */
-function validateIndexableGuides(discovery) {
-  const guides = /** @type {{ path: string; navLabel: string; problemAnchor: string }[]} */ (
-    discovery.indexableGuides
-  );
-  if (!Array.isArray(guides)) {
-    throw new Error("discovery-acquisition: indexableGuides must be an array");
-  }
-  const paths = guides.map((g) => String(g.path));
-  const uniq = new Set(paths);
-  if (uniq.size !== paths.length) {
-    throw new Error("discovery-acquisition: indexableGuides paths must be unique");
-  }
-  const demandMoments = /** @type {string[]} */ (discovery.demandMoments);
-  for (let k = 0; k < guides.length; k++) {
-    const pa = String(guides[k].problemAnchor);
-    if (pa.includes("`")) {
-      throw new Error("discovery-acquisition: problemAnchor must not contain backtick");
-    }
-    if (k >= 1) {
-      const dm = String(demandMoments[k - 1]);
-      if (!dm.includes(pa)) {
-        throw new Error(
-          `discovery-acquisition: indexableGuides[${k}].problemAnchor must be a substring of demandMoments[${k - 1}]`,
-        );
-      }
-    }
-  }
-}
-
-/**
- * @param {Record<string, unknown>} discovery
- */
-function validateIndexableExamples(discovery) {
-  const ex = /** @type {{ path: string; navLabel: string; problemAnchor: string; embedKey: string }[]} */ (
-    discovery.indexableExamples
-  );
-  if (!Array.isArray(ex)) {
-    throw new Error("discovery-acquisition: indexableExamples must be an array");
-  }
-  if (ex.length !== 2) {
-    throw new Error("discovery-acquisition: indexableExamples must have length exactly 2");
-  }
-  if (ex[0].path !== "/examples/wf-complete" || ex[1].path !== "/examples/wf-missing") {
-    throw new Error(
-      "discovery-acquisition: indexableExamples paths must be /examples/wf-complete then /examples/wf-missing",
-    );
-  }
-  if (ex[0].embedKey !== "wf_complete" || ex[1].embedKey !== "wf_missing") {
-    throw new Error(
-      "discovery-acquisition: indexableExamples embedKey order must be wf_complete then wf_missing",
-    );
-  }
-  for (let i = 0; i < ex.length; i++) {
-    const row = ex[i];
-    const nl = String(row.navLabel);
-    const pa = String(row.problemAnchor);
-    if (nl.includes("`") || pa.includes("`")) {
-      throw new Error(`discovery-acquisition: indexableExamples[${i}] must not contain backtick`);
-    }
-  }
-}
-
 /**
  * @param {string} baseLlms
  * @param {Record<string, unknown>} discovery
@@ -162,18 +127,24 @@ function appendDiscoveryLlmsAppendix(baseLlms, discovery, canonicalOrigin) {
   const bullets = (/** @type {string[]} */ arr) => arr.map((x) => `- ${x}`).join("\n");
 
   let out = String(baseLlms).replace(/\s*$/, "") + "\n";
-  const guides = /** @type {{ path: string }[] | undefined} */ (discovery.indexableGuides);
-  if (Array.isArray(guides) && guides.length > 0) {
+  const root = join(__dirname, "..");
+  const grouped = listMarkdownSurfaceRoutesGrouped(root);
+  if (grouped.guides.length > 0) {
     out += "\n## Indexable guides\n";
-    for (const g of guides) {
-      out += `- ${origin}${String(g.path)}\n`;
+    for (const path of grouped.guides) {
+      out += `- ${origin}${path}\n`;
     }
   }
-  const examples = /** @type {{ path: string }[] | undefined} */ (discovery.indexableExamples);
-  if (Array.isArray(examples) && examples.length > 0) {
+  if (grouped.examples.length > 0) {
     out += "\n## Indexable examples\n";
-    for (const ex of examples) {
-      out += `- ${origin}${String(ex.path)}\n`;
+    for (const path of grouped.examples) {
+      out += `- ${origin}${path}\n`;
+    }
+  }
+  if (grouped.compare.length > 0) {
+    out += "\n## Indexable comparisons\n";
+    for (const path of grouped.compare) {
+      out += `- ${origin}${path}\n`;
     }
   }
   const demo = discovery.shareableTerminalDemo;
@@ -186,9 +157,15 @@ function appendDiscoveryLlmsAppendix(baseLlms, discovery, canonicalOrigin) {
   out += bullets(llms.notFor) + "\n";
   out += "\n## Related queries\n";
   out += bullets(llms.relatedQueries) + "\n";
-  const moments = /** @type {string[]} */ (discovery.demandMoments);
+  const rows = /** @type {{ moment: string; primaryRoute: string; relatedRoutes?: string[] }[]} */ (
+    discovery.problemIndex
+  );
   out += "\n## When this hurts (search-shaped)\n";
-  out += bullets(moments) + "\n";
+  for (const row of rows) {
+    const paths = [row.primaryRoute, ...(Array.isArray(row.relatedRoutes) ? row.relatedRoutes : [])];
+    const links = paths.map((p) => `${origin}${String(p).startsWith("/") ? String(p) : `/${String(p)}`}`);
+    out += `- ${row.moment} — ${links.join(" · ")}\n`;
+  }
   out += "\n## Problem framing (shareable)\n";
   out += `- Full page: ${origin}${slug}\n`;
   out += "\n## Visitor problem (canonical answer)\n\n";
@@ -221,8 +198,6 @@ function validateDiscoveryAcquisition(root) {
       "discovery-acquisition: shareableTerminalDemo.transcript must not contain markdown fence ```",
     );
   }
-  validateIndexableGuides(discovery);
-  validateIndexableExamples(discovery);
   return discovery;
 }
 
@@ -231,7 +206,6 @@ module.exports = {
   buildDiscoveryFoldBody,
   appendDiscoveryLlmsAppendix,
   validateDiscoveryAcquisition,
-  validateIndexableGuides,
-  validateIndexableExamples,
   discoveryPaths,
+  listMarkdownSurfaceRoutesGrouped,
 };

package/scripts/discovery-payload.lib.cjs

@@ -105,6 +105,33 @@ function buildDiscoveryPayload(root) {
   const discoveryLib = require("./discovery-acquisition.lib.cjs");
   discoveryLib.validateDiscoveryAcquisition(root);
   const discovery = discoveryLib.loadDiscoveryAcquisition(root);
+  const grouped = discoveryLib.listMarkdownSurfaceRoutesGrouped(root);
+  const padAnchor = (path) =>
+    `Markdown-backed discovery surface content for ${path} — read-only SQL verification context.`;
+  const indexableGuidesFromMd = grouped.guides.map((path) => ({
+    path,
+    navLabel: path.replace(/^\/guides\//, ""),
+    problemAnchor: padAnchor(path),
+  }));
+  const embedKeyForExamplePath = (examplePath) => {
+    const tail = String(examplePath).replace(/^\/examples\//, "");
+    switch (tail) {
+      case "wf-complete":
+        return "wf_complete";
+      case "wf-missing":
+        return "wf_missing";
+      case "langgraph-checkpoint-trust":
+        return "langgraph_checkpoint_trust";
+      default:
+        throw new Error(`discovery-payload: unknown example path for embedKey: ${examplePath}`);
+    }
+  };
+  const indexableExamplesFromMd = grouped.examples.map((path) => ({
+    path,
+    navLabel: path.replace(/^\/examples\//, ""),
+    problemAnchor: padAnchor(path),
+    embedKey: embedKeyForExamplePath(path),
+  }));
   const anchorsPath = join(root, "config", "public-product-anchors.json");
   const anchors = JSON.parse(readFileSync(anchorsPath, "utf8"));
   const canonicalOrigin = normalizeOrigin(anchors.productionCanonicalOrigin);
@@ -140,9 +167,11 @@ function buildDiscoveryPayload(root) {
       intentPhrases: llms.intentPhrases.map(String),
       notFor: llms.notFor.map(String),
       relatedQueries: llms.relatedQueries.map(String),
-      demandMoments: /** @type {string[]} */ (discovery.demandMoments).map(String),
-      indexableGuides: /** @type {unknown} */ (discovery.indexableGuides),
-      indexableExamples: /** @type {unknown} */ (discovery.indexableExamples),
+      problemIndex: /** @type {unknown} */ (
+        Array.isArray(discovery.problemIndex) ? JSON.parse(JSON.stringify(discovery.problemIndex)) : []
+      ),
+      indexableGuides: /** @type {unknown} */ (indexableGuidesFromMd),
+      indexableExamples: /** @type {unknown} */ (indexableExamplesFromMd),
       shareableTerminalDemo: {
         title: String(demo.title),
         transcript: String(demo.transcript),
@@ -155,13 +184,13 @@ function buildDiscoveryPayload(root) {
  * @param {Record<string, unknown>} payload
  */
 function discoveryObjectFromAppendix(payload) {
-  const ap = /** @type {{ slug: string; visitorProblemAnswer: string; intentPhrases: string[]; notFor: string[]; relatedQueries: string[]; demandMoments: string[]; indexableGuides?: { path: string; navLabel: string; problemAnchor: string }[]; indexableExamples?: { path: string; navLabel: string; problemAnchor: string; embedKey: string }[]; shareableTerminalDemo?: { title: string; transcript: string } }} */ (
+  const ap = /** @type {{ slug: string; visitorProblemAnswer: string; intentPhrases: string[]; notFor: string[]; relatedQueries: string[]; problemIndex: { moment: string; primaryRoute: string; relatedRoutes?: string[] }[]; indexableGuides?: { path: string; navLabel: string; problemAnchor: string }[]; indexableExamples?: { path: string; navLabel: string; problemAnchor: string; embedKey: string }[]; shareableTerminalDemo?: { title: string; transcript: string } }} */ (
     payload.appendix
   );
   const out = {
     slug: ap.slug,
     visitorProblemAnswer: ap.visitorProblemAnswer,
-    demandMoments: ap.demandMoments,
+    problemIndex: ap.problemIndex,
     llms: {
       intentPhrases: ap.intentPhrases,
       notFor: ap.notFor,

package/dist/withWorkflowVerification.persistBundle.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=withWorkflowVerification.persistBundle.test.d.ts.map

package/dist/withWorkflowVerification.persistBundle.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"withWorkflowVerification.persistBundle.test.d.ts","sourceRoot":"","sources":["../src/withWorkflowVerification.persistBundle.test.ts"],"names":[],"mappings":""}

package/dist/withWorkflowVerification.persistBundle.test.js.map

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