@taifoon/jev 0.1.0 → 0.2.1

package/examples/jobs/invoice-extraction.json

@@ -0,0 +1,24 @@
+{
+  "_note": "ILLUSTRATIVE job written by hand to show the data a grader needs. Not a real delivery.",
+  "id": "example:invoice-extraction",
+  "task": "Extract the invoice into JSON with invoice_no, total, currency and due_date",
+  "criteria": [
+    "Returns one JSON object with exactly the four fields",
+    "Every value matches the source invoice",
+    "due_date is ISO 8601 (YYYY-MM-DD)"
+  ],
+  "source": "INVOICE INV-20931\nIssued 2026-09-01 by Northwind Parts GmbH\nTotal due: EUR 1,240.50\nPayment due by 2026-10-01",
+  "delivered": "{\"invoice_no\": \"INV-20931\", \"total\": 1240.50, \"currency\": \"EUR\", \"due_date\": \"2026-10-01\"}",
+  "checks": [
+    {
+      "kind": "json",
+      "keys": [
+        "invoice_no",
+        "total",
+        "currency",
+        "due_date"
+      ]
+    }
+  ],
+  "priceUsdc": 0.2
+}

package/examples/jobs/research-report-no-sources.json

@@ -0,0 +1,29 @@
+{
+  "_note": "ILLUSTRATIVE job written by hand to show the data a grader needs. Not a real delivery.",
+  "id": "example:research-report-no-sources",
+  "chainId": 8453,
+  "task": "equity_research where ticker is 'AAPL'",
+  "criteria": [
+    "Names the ticker AAPL",
+    "Lists at least three risks, each with one sentence of reasoning",
+    "Ends with one call: BUY, HOLD or SELL",
+    "Cites at least two public sources by link",
+    "States no figure it does not source"
+  ],
+  "delivered": "AAPL looks strong. Risks: China, regulation, supply chain. Call: BUY.",
+  "checks": [
+    {
+      "kind": "includes",
+      "terms": [
+        "AAPL",
+        "BUY"
+      ],
+      "name": "names the ticker and a call"
+    },
+    {
+      "kind": "sources",
+      "min": 2
+    }
+  ],
+  "priceUsdc": 1.5
+}

package/examples/jobs/research-report.json

@@ -0,0 +1,34 @@
+{
+  "_note": "ILLUSTRATIVE job written by hand to show the data a grader needs. Not a real delivery.",
+  "id": "example:research-report",
+  "chainId": 8453,
+  "task": "equity_research where ticker is 'AAPL'",
+  "criteria": [
+    "Names the ticker AAPL",
+    "Lists at least three risks, each with one sentence of reasoning",
+    "Ends with one call: BUY, HOLD or SELL",
+    "Cites at least two public sources by link",
+    "States no figure it does not source"
+  ],
+  "delivered": "AAPL equity research, 26 September 2026.\nPrice context: AAPL closed at the level shown on the source page linked below; this report does not restate a price it cannot cite.\nRisks:\n1. China demand: a slowdown in the Greater China segment would hit iPhone revenue first.\n2. Regulation: app store rules in the EU and the US could cut services margins.\n3. Supply chain: assembly is concentrated in a few regions.\nCall: HOLD. The three risks balance the services growth described in the latest filing.\nSources:\n- https://investor.apple.com/sec-filings/default.aspx\n- https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193",
+  "checks": [
+    {
+      "kind": "includes",
+      "terms": [
+        "AAPL",
+        "HOLD"
+      ],
+      "name": "names the ticker and a call"
+    },
+    {
+      "kind": "sources",
+      "min": 2
+    },
+    {
+      "kind": "deadline",
+      "submittedAt": "2026-09-26T10:00:00Z",
+      "deadline": "2026-09-27T00:00:00Z"
+    }
+  ],
+  "priceUsdc": 1.5
+}

package/examples/jobs/signal-unsupported.json

@@ -0,0 +1,27 @@
+{
+  "_note": "ILLUSTRATIVE job written by hand to show the data a grader needs. Not a real delivery.",
+  "id": "example:signal-unsupported",
+  "chainId": 8453,
+  "task": "Give me the current oracle signal for BTC with its EV score and the data it rests on",
+  "criteria": [
+    "Gives one signal: LONG, SHORT or FLAT",
+    "Gives an EV score",
+    "Shows the data the score rests on, by link"
+  ],
+  "delivered": "BTC signal: LONG. EV score 0.87, backtested win rate 91% over 5 years, guaranteed edge. Data: https://example.com/btc",
+  "checks": [
+    {
+      "kind": "includes",
+      "terms": [
+        "BTC",
+        "LONG"
+      ],
+      "name": "gives a signal"
+    },
+    {
+      "kind": "sources",
+      "min": 1
+    }
+  ],
+  "priceUsdc": 1
+}

package/examples/quickstart.mjs

@@ -0,0 +1,22 @@
+// Did the agent do the work it was hired for, as the task laid it out? One job, graded end to end.
+//   TYPESAFE_KEY=… node examples/quickstart.mjs        (your own key, from console.typesafe.ai)
+import { prepareJob, facts, grade, record, evaluatorCall, verify } from '@taifoon/jev';
+
+// 1. The job as the buyer laid it out, and what the agent handed in (illustrative).
+const job = prepareJob({
+  id: 'job-4711', chainId: 8453,
+  task: 'Extract the invoice into JSON with invoice_no, total, currency and due_date',
+  criteria: ['Returns one JSON object with exactly the four fields', 'Every value matches the source invoice', 'due_date is ISO 8601'],
+  source: 'INVOICE INV-20931 · Total due: EUR 1,240.50 · Payment due by 2026-10-01',
+  delivered: '{"invoice_no":"INV-20931","total":1240.50,"currency":"EUR","due_date":"2026-10-01"}',
+  checks: [{ kind: 'json', keys: ['invoice_no', 'total', 'currency', 'due_date'] }],   // code checks first
+});
+
+// 2. Code states the facts; Jev answers the rubric about the delivery against the criteria and the source.
+const receipt = await grade({ subject: job.subject, evidence: job.evidence, facts: facts(job.facts), key: process.env.TYPESAFE_KEY });
+console.log(receipt.verdict, '·', receipt.reasons[0]);
+
+// 3. The record and the call that ends the job, both unsigned: whoever holds the seat signs.
+const onchain = await record(receipt);
+const end = evaluatorCall('virtuals-erc8183', 4711n, receipt, receipt);
+console.log(onchain.calls.map((c) => c.fn), '→', end?.fn, '· verifies:', (await verify(receipt, { chain: false })).ok);

package/package.json

@@ -1,18 +1,24 @@
 {
   "name": "@taifoon/jev",
-  "version": "0.1.0",
-  "description": "Jev as an on-chain grader for any protocol: deterministic facts, calibrated atomic answers, a composed verdict, a receipt, the on-chain record and the evaluator call. No runtime dependencies, no key inside.",
+  "version": "0.2.1",
+  "description": "Grade AI agent jobs with TypeSafe's Jev and record the verdict on chain: code checks the facts, Jev answers a published rubric, and you get a receipt, the on-chain record and the evaluator call for ERC-8183 and Virtuals ACP. No runtime dependencies, no key inside.",
   "keywords": [
     "jev",
     "typesafe",
-    "judge",
-    "grader",
+    "typesafe-ai",
+    "system-one",
+    "llm-as-a-judge",
+    "llm-judge",
     "evaluator",
+    "grader",
     "erc-8183",
-    "agentic-commerce",
+    "virtuals",
     "acp",
+    "agentic-commerce",
+    "ai-agents",
     "on-chain",
-    "calibrated"
+    "attestation",
+    "base"
   ],
   "license": "MIT",
   "author": {
@@ -20,14 +26,13 @@
     "email": "yawning.monsoon@proton.me",
     "url": "https://github.com/taifoon-io"
   },
-  "homepage": "https://github.com/taifoon-io/n8n-nodes-typesafe/tree/main/jev#readme",
+  "homepage": "https://github.com/taifoon-io/jev#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/taifoon-io/n8n-nodes-typesafe.git",
-    "directory": "jev"
+    "url": "git+https://github.com/taifoon-io/jev.git"
   },
   "bugs": {
-    "url": "https://github.com/taifoon-io/n8n-nodes-typesafe/issues"
+    "url": "https://github.com/taifoon-io/jev/issues"
   },
   "type": "module",
   "main": "./dist/index.js",
@@ -42,6 +47,8 @@
     "dist",
     "bin",
     "workflows",
+    "docs",
+    "examples",
     "README.md",
     "LICENSE"
   ],
@@ -68,6 +75,7 @@
     "vitest": "^4.1.8"
   },
   "bin": {
-    "jev": "bin/jev.mjs"
+    "jev": "bin/jev.mjs",
+    "taifoon-jev": "bin/jev.mjs"
   }
 }

package/workflows/{0.1.0 → 0.2.1}/README.md

@@ -1,4 +1,4 @@
-# Jev workflows 0.1.0
+# Jev workflows 0.2.1
 
 The n8n workflows that run Jev on n8n.taifoon.dev, exported with credential references replaced by placeholders (`{ "id": "", "name": "REPLACE: <credential type>" }`: pick your own credential of that type after import). Import with n8n → Workflows → Import from File, or `n8n import:workflow --input=<file>`. Every step carries its contract: `meta.taifoon.steps` names the canonical entity it takes and emits by `$id`; the schemas are in `schemas/` (the `$id`s are identifiers, the files are here).
 
@@ -50,7 +50,7 @@ One hire from offer to settlement. The seller’s reply is held with its digest;
 
 Grades Base jobs that were paid and delivered and that nobody ruled on (GET /v1/judge/ready): four per run, each through prepare → Jev → answers, then the canonical verdict, then GradeStampRegistry.stamp on the devnet, signed by the devnet signer node; the stamp transaction is appended to the verdict’s anchors.
 
-- source: `tfnjevgrader0001` on n8n.taifoon.dev · sha256 `06159f5ee2ea51644d1cca6cbdc79024fb565bee0720e622f97e52a28652c98d`
+- source: `tfnjevgrader0001` on n8n.taifoon.dev · sha256 `762248c554dd0607362e20361ec3efe0fda58326d89c2f1c18c525ea48e92e35`
 - nodes: `n8n-nodes-taifoon`, `@taifoon/n8n-nodes-typesafe`, `n8n-nodes-taifoon-devnet-signer`; built-ins manualTrigger v1, code v2, if v2.2
 - credentials: `taifoonRelayerApi`, `taifoonTypeSafeApi`, `taifoonDevnetKeyApi`
 
@@ -91,7 +91,7 @@ A batch of subjects, each as its own prepare → Jev → answers (so every answe
 
 Takes one recorded decision (by id), maps it to the canonical verdict, and stamps it on the devnet GradeStampRegistry; emits the verdict with the stamp transaction in its anchors.
 
-- source: `tfnstamp00000001` on n8n.taifoon.dev · sha256 `4464558aa9593b2bf3f2cbb6b95a0c7d2ab83c549947f96195322624da7028e4`
+- source: `tfnstamp00000001` on n8n.taifoon.dev · sha256 `516d9483e3d26e1891dacb8c4493d609340e3c6a3b200784c72864f9cb931ebc`
 - nodes: `n8n-nodes-taifoon`, `n8n-nodes-taifoon-devnet-signer`; built-ins manualTrigger v1, code v2
 - credentials: `taifoonDevnetKeyApi`
 

package/workflows/{0.1.0 → 0.2.1}/jev-grader.json

@@ -174,7 +174,7 @@
     {
       "parameters": {
         "mode": "runOnceForEachItem",
-        "jsCode": "// ── canonical VERDICT (taifoon.verdict.v1) from a decision record — the same mapping as schemas/src/from/judge.ts\n// fromDecision, inlined because an n8n code node cannot import the schemas package. workflows/test.mjs runs this node\n// and compares its output with fromDecision field by field.\nconst SITE = 'https://www.taifoon.io';\nconst isHash = (s) => typeof s === 'string' && /^0x[0-9a-fA-F]{64}$/.test(s);\nconst chainAnchor = (chain_id, tx, what, x = {}) => ({ kind: 'chain', chain_id, tx: tx.toLowerCase(), block: x.block ?? null, ts: x.ts ?? null, log_index: x.log_index ?? null, contract: x.contract ? x.contract.toLowerCase() : null, what });\nfunction jobKeyOf(subject) {\n  const ref = String(subject && subject.ref || ''), chain = Number(subject && subject.chainId) || 8453;\n  if (/^hs_[0-9a-f]{24}$/.test(ref)) return 'hs:' + ref;\n  if (/^([a-z][a-z0-9-]{0,31}):([1-9][0-9]{0,9}):([0-9]{1,78})$/.test(ref)) return ref;\n  if (/^0x[0-9a-fA-F]{64}$/.test(ref)) return 'hook:' + chain + ':' + ref.toLowerCase();\n  if (/^[0-9]{1,78}$/.test(ref)) return /^[0-9]{10,12}$/.test(ref) && BigInt(ref) >= 1000000001n ? 'memo-acp:8453:' + ref : 'erc8183:' + chain + ':' + ref;\n  return null;\n}\nfunction verdictFromDecision(d, composed) {\n  const rubric = /RUBRIC_v1 compose · rubric (0x[0-9a-f]{64})/.exec(String(d.note ?? ''));\n  const anchors = [];\n  if (d.anchor && isHash(d.anchor.tx)) anchors.push(chainAnchor(Number(d.anchor.chain), d.anchor.tx, `JevDecisionLog.record${d.anchor.index != null ? ` (decision index ${d.anchor.index})` : ''} · status ${d.anchor.status}`, { block: d.anchor.block ?? null, contract: d.anchor.contract ?? null }));\n  anchors.push({ kind: 'offchain', store: 'coordd:decisions', key: String(d.id), digest: isHash(d.digest) ? d.digest.toLowerCase() : null, anchored_by: anchors[0] && anchors[0].kind === 'chain' ? anchors[0] : null, what: 'the decision record; digest = sha256(canonicalDecision)' });\n  return {\n    schema: 'taifoon.verdict.v1', decision_id: String(d.id), version: d.v, kind: d.kind,\n    subject: { chain_id: Number(d.subject && d.subject.chainId), at: d.subject && d.subject.at ? String(d.subject.at).toLowerCase() : null, ref: String(d.subject && d.subject.ref), label: (d.subject && d.subject.label) ?? null },\n    subject_id: String(d.subject_id).toLowerCase(), subject_job_key: jobKeyOf(d.subject), digest: String(d.digest).toLowerCase(),\n    input_digest: isHash(d.input_digest) ? d.input_digest.toLowerCase() : null, answers_digest: isHash(d.answers_digest) ? d.answers_digest.toLowerCase() : null,\n    answers: (d.answers || []).map((a) => ({ id: String(a.id), question: a.question ?? null, options: a.options ?? null, value: String(a.value), probabilities: a.probabilities ?? {}, confidence: Number(a.confidence) })),\n    confidence_bps: d.confidence_bps, model: d.model ?? null, answers_source: d.answers_source ?? 'layer',\n    rubric: rubric ? { version: 'RUBRIC_v1', hash: rubric[1] } : null,\n    composed: composed ? { verdict: composed.verdict, auto: Boolean(composed.auto), forced: composed.forced ?? null, reasons: (composed.reasons || []).map(String), receipt_hash: isHash(composed.receiptHash) ? composed.receiptHash.toLowerCase() : null } : null,\n    anchors, source: { kind: 'decision', url: d.uri ?? `${SITE}/v1/judge/decisions/${d.id}`, read_at: Math.floor(Date.now() / 1000) },\n  };\n}\n// the GradeStampRegistry verdict code (1 delivered_as_specified · 2 delivered_with_defects · 3 not_delivered · 4 cannot_determine)\nconst STAMP_CODE = { delivered_as_specified: 1, delivered_with_defects: 2, not_delivered: 3, cannot_determine: 4 };\nfunction stampCodeOf(v) {\n  if (v.composed) return v.composed.verdict === 'complete' ? 1 : v.composed.verdict === 'reject' ? 2 : 4;\n  const ref = (v.answers || []).find((a) => STAMP_CODE[a.value]);\n  return ref ? STAMP_CODE[ref.value] : 4;\n}\n// the stamp transaction(s) the devnet signer mined → appended to the verdict's anchors\nconst stampAnchors = (sent, chainId) => (sent || []).filter((s) => isHash(s.tx) && s.status === 'success').map((s) => chainAnchor(chainId, s.tx, 'GradeStampRegistry.stamp (' + (s.action || 'stamp') + ')', { block: s.block ?? null, contract: s.to ?? null }));\n\n// the recorded decision → the canonical VERDICT, composed from this run's receipt\nconst a = $json;\nif (!a.decision || !a.decision.id) throw new Error('judge answers returned no decision: ' + JSON.stringify(a).slice(0, 300));\nconst d = (await this.helpers.httpRequest({ method: 'GET', url: SITE + '/v1/judge/decisions/' + a.decision.id, json: true })).decision;\nconst v = verdictFromDecision(d, a.receipt);\nreturn { json: { ...v, stamp: { code: stampCodeOf(v), mode: 2 } } };"
+        "jsCode": "// ── canonical VERDICT (taifoon.verdict.v1) from a decision record — the same mapping as the Taifoon verdict schema\n// fromDecision, inlined because an n8n code node cannot import the schemas package. workflows/test.mjs runs this node\n// and compares its output with fromDecision field by field.\nconst SITE = 'https://www.taifoon.io';\nconst isHash = (s) => typeof s === 'string' && /^0x[0-9a-fA-F]{64}$/.test(s);\nconst chainAnchor = (chain_id, tx, what, x = {}) => ({ kind: 'chain', chain_id, tx: tx.toLowerCase(), block: x.block ?? null, ts: x.ts ?? null, log_index: x.log_index ?? null, contract: x.contract ? x.contract.toLowerCase() : null, what });\nfunction jobKeyOf(subject) {\n  const ref = String(subject && subject.ref || ''), chain = Number(subject && subject.chainId) || 8453;\n  if (/^hs_[0-9a-f]{24}$/.test(ref)) return 'hs:' + ref;\n  if (/^([a-z][a-z0-9-]{0,31}):([1-9][0-9]{0,9}):([0-9]{1,78})$/.test(ref)) return ref;\n  if (/^0x[0-9a-fA-F]{64}$/.test(ref)) return 'hook:' + chain + ':' + ref.toLowerCase();\n  if (/^[0-9]{1,78}$/.test(ref)) return /^[0-9]{10,12}$/.test(ref) && BigInt(ref) >= 1000000001n ? 'memo-acp:8453:' + ref : 'erc8183:' + chain + ':' + ref;\n  return null;\n}\nfunction verdictFromDecision(d, composed) {\n  const rubric = /RUBRIC_v1 compose · rubric (0x[0-9a-f]{64})/.exec(String(d.note ?? ''));\n  const anchors = [];\n  if (d.anchor && isHash(d.anchor.tx)) anchors.push(chainAnchor(Number(d.anchor.chain), d.anchor.tx, `JevDecisionLog.record${d.anchor.index != null ? ` (decision index ${d.anchor.index})` : ''} · status ${d.anchor.status}`, { block: d.anchor.block ?? null, contract: d.anchor.contract ?? null }));\n  anchors.push({ kind: 'offchain', store: 'coordd:decisions', key: String(d.id), digest: isHash(d.digest) ? d.digest.toLowerCase() : null, anchored_by: anchors[0] && anchors[0].kind === 'chain' ? anchors[0] : null, what: 'the decision record; digest = sha256(canonicalDecision)' });\n  return {\n    schema: 'taifoon.verdict.v1', decision_id: String(d.id), version: d.v, kind: d.kind,\n    subject: { chain_id: Number(d.subject && d.subject.chainId), at: d.subject && d.subject.at ? String(d.subject.at).toLowerCase() : null, ref: String(d.subject && d.subject.ref), label: (d.subject && d.subject.label) ?? null },\n    subject_id: String(d.subject_id).toLowerCase(), subject_job_key: jobKeyOf(d.subject), digest: String(d.digest).toLowerCase(),\n    input_digest: isHash(d.input_digest) ? d.input_digest.toLowerCase() : null, answers_digest: isHash(d.answers_digest) ? d.answers_digest.toLowerCase() : null,\n    answers: (d.answers || []).map((a) => ({ id: String(a.id), question: a.question ?? null, options: a.options ?? null, value: String(a.value), probabilities: a.probabilities ?? {}, confidence: Number(a.confidence) })),\n    confidence_bps: d.confidence_bps, model: d.model ?? null, answers_source: d.answers_source ?? 'layer',\n    rubric: rubric ? { version: 'RUBRIC_v1', hash: rubric[1] } : null,\n    composed: composed ? { verdict: composed.verdict, auto: Boolean(composed.auto), forced: composed.forced ?? null, reasons: (composed.reasons || []).map(String), receipt_hash: isHash(composed.receiptHash) ? composed.receiptHash.toLowerCase() : null } : null,\n    anchors, source: { kind: 'decision', url: d.uri ?? `${SITE}/v1/judge/decisions/${d.id}`, read_at: Math.floor(Date.now() / 1000) },\n  };\n}\n// the GradeStampRegistry verdict code (1 delivered_as_specified · 2 delivered_with_defects · 3 not_delivered · 4 cannot_determine)\nconst STAMP_CODE = { delivered_as_specified: 1, delivered_with_defects: 2, not_delivered: 3, cannot_determine: 4 };\nfunction stampCodeOf(v) {\n  if (v.composed) return v.composed.verdict === 'complete' ? 1 : v.composed.verdict === 'reject' ? 2 : 4;\n  const ref = (v.answers || []).find((a) => STAMP_CODE[a.value]);\n  return ref ? STAMP_CODE[ref.value] : 4;\n}\n// the stamp transaction(s) the devnet signer mined → appended to the verdict's anchors\nconst stampAnchors = (sent, chainId) => (sent || []).filter((s) => isHash(s.tx) && s.status === 'success').map((s) => chainAnchor(chainId, s.tx, 'GradeStampRegistry.stamp (' + (s.action || 'stamp') + ')', { block: s.block ?? null, contract: s.to ?? null }));\n\n// the recorded decision → the canonical VERDICT, composed from this run's receipt\nconst a = $json;\nif (!a.decision || !a.decision.id) throw new Error('judge answers returned no decision: ' + JSON.stringify(a).slice(0, 300));\nconst d = (await this.helpers.httpRequest({ method: 'GET', url: SITE + '/v1/judge/decisions/' + a.decision.id, json: true })).decision;\nconst v = verdictFromDecision(d, a.receipt);\nreturn { json: { ...v, stamp: { code: stampCodeOf(v), mode: 2 } } };"
       },
       "id": "dd2f2612-43ba-4e52-aa54-bf147e4dd561",
       "name": "Verdict",
@@ -236,7 +236,7 @@
     {
       "parameters": {
         "mode": "runOnceForEachItem",
-        "jsCode": "// ── canonical VERDICT (taifoon.verdict.v1) from a decision record — the same mapping as schemas/src/from/judge.ts\n// fromDecision, inlined because an n8n code node cannot import the schemas package. workflows/test.mjs runs this node\n// and compares its output with fromDecision field by field.\nconst SITE = 'https://www.taifoon.io';\nconst isHash = (s) => typeof s === 'string' && /^0x[0-9a-fA-F]{64}$/.test(s);\nconst chainAnchor = (chain_id, tx, what, x = {}) => ({ kind: 'chain', chain_id, tx: tx.toLowerCase(), block: x.block ?? null, ts: x.ts ?? null, log_index: x.log_index ?? null, contract: x.contract ? x.contract.toLowerCase() : null, what });\nfunction jobKeyOf(subject) {\n  const ref = String(subject && subject.ref || ''), chain = Number(subject && subject.chainId) || 8453;\n  if (/^hs_[0-9a-f]{24}$/.test(ref)) return 'hs:' + ref;\n  if (/^([a-z][a-z0-9-]{0,31}):([1-9][0-9]{0,9}):([0-9]{1,78})$/.test(ref)) return ref;\n  if (/^0x[0-9a-fA-F]{64}$/.test(ref)) return 'hook:' + chain + ':' + ref.toLowerCase();\n  if (/^[0-9]{1,78}$/.test(ref)) return /^[0-9]{10,12}$/.test(ref) && BigInt(ref) >= 1000000001n ? 'memo-acp:8453:' + ref : 'erc8183:' + chain + ':' + ref;\n  return null;\n}\nfunction verdictFromDecision(d, composed) {\n  const rubric = /RUBRIC_v1 compose · rubric (0x[0-9a-f]{64})/.exec(String(d.note ?? ''));\n  const anchors = [];\n  if (d.anchor && isHash(d.anchor.tx)) anchors.push(chainAnchor(Number(d.anchor.chain), d.anchor.tx, `JevDecisionLog.record${d.anchor.index != null ? ` (decision index ${d.anchor.index})` : ''} · status ${d.anchor.status}`, { block: d.anchor.block ?? null, contract: d.anchor.contract ?? null }));\n  anchors.push({ kind: 'offchain', store: 'coordd:decisions', key: String(d.id), digest: isHash(d.digest) ? d.digest.toLowerCase() : null, anchored_by: anchors[0] && anchors[0].kind === 'chain' ? anchors[0] : null, what: 'the decision record; digest = sha256(canonicalDecision)' });\n  return {\n    schema: 'taifoon.verdict.v1', decision_id: String(d.id), version: d.v, kind: d.kind,\n    subject: { chain_id: Number(d.subject && d.subject.chainId), at: d.subject && d.subject.at ? String(d.subject.at).toLowerCase() : null, ref: String(d.subject && d.subject.ref), label: (d.subject && d.subject.label) ?? null },\n    subject_id: String(d.subject_id).toLowerCase(), subject_job_key: jobKeyOf(d.subject), digest: String(d.digest).toLowerCase(),\n    input_digest: isHash(d.input_digest) ? d.input_digest.toLowerCase() : null, answers_digest: isHash(d.answers_digest) ? d.answers_digest.toLowerCase() : null,\n    answers: (d.answers || []).map((a) => ({ id: String(a.id), question: a.question ?? null, options: a.options ?? null, value: String(a.value), probabilities: a.probabilities ?? {}, confidence: Number(a.confidence) })),\n    confidence_bps: d.confidence_bps, model: d.model ?? null, answers_source: d.answers_source ?? 'layer',\n    rubric: rubric ? { version: 'RUBRIC_v1', hash: rubric[1] } : null,\n    composed: composed ? { verdict: composed.verdict, auto: Boolean(composed.auto), forced: composed.forced ?? null, reasons: (composed.reasons || []).map(String), receipt_hash: isHash(composed.receiptHash) ? composed.receiptHash.toLowerCase() : null } : null,\n    anchors, source: { kind: 'decision', url: d.uri ?? `${SITE}/v1/judge/decisions/${d.id}`, read_at: Math.floor(Date.now() / 1000) },\n  };\n}\n// the GradeStampRegistry verdict code (1 delivered_as_specified · 2 delivered_with_defects · 3 not_delivered · 4 cannot_determine)\nconst STAMP_CODE = { delivered_as_specified: 1, delivered_with_defects: 2, not_delivered: 3, cannot_determine: 4 };\nfunction stampCodeOf(v) {\n  if (v.composed) return v.composed.verdict === 'complete' ? 1 : v.composed.verdict === 'reject' ? 2 : 4;\n  const ref = (v.answers || []).find((a) => STAMP_CODE[a.value]);\n  return ref ? STAMP_CODE[ref.value] : 4;\n}\n// the stamp transaction(s) the devnet signer mined → appended to the verdict's anchors\nconst stampAnchors = (sent, chainId) => (sent || []).filter((s) => isHash(s.tx) && s.status === 'success').map((s) => chainAnchor(chainId, s.tx, 'GradeStampRegistry.stamp (' + (s.action || 'stamp') + ')', { block: s.block ?? null, contract: s.to ?? null }));\n\n// the same VERDICT with the GradeStampRegistry stamp transaction appended to its anchors\nconst v = { ...$('Verdict').item.json };\ndelete v.stamp;\nreturn { json: { ...v, anchors: [...v.anchors, ...stampAnchors($json.sent, 36927)] } };"
+        "jsCode": "// ── canonical VERDICT (taifoon.verdict.v1) from a decision record — the same mapping as the Taifoon verdict schema\n// fromDecision, inlined because an n8n code node cannot import the schemas package. workflows/test.mjs runs this node\n// and compares its output with fromDecision field by field.\nconst SITE = 'https://www.taifoon.io';\nconst isHash = (s) => typeof s === 'string' && /^0x[0-9a-fA-F]{64}$/.test(s);\nconst chainAnchor = (chain_id, tx, what, x = {}) => ({ kind: 'chain', chain_id, tx: tx.toLowerCase(), block: x.block ?? null, ts: x.ts ?? null, log_index: x.log_index ?? null, contract: x.contract ? x.contract.toLowerCase() : null, what });\nfunction jobKeyOf(subject) {\n  const ref = String(subject && subject.ref || ''), chain = Number(subject && subject.chainId) || 8453;\n  if (/^hs_[0-9a-f]{24}$/.test(ref)) return 'hs:' + ref;\n  if (/^([a-z][a-z0-9-]{0,31}):([1-9][0-9]{0,9}):([0-9]{1,78})$/.test(ref)) return ref;\n  if (/^0x[0-9a-fA-F]{64}$/.test(ref)) return 'hook:' + chain + ':' + ref.toLowerCase();\n  if (/^[0-9]{1,78}$/.test(ref)) return /^[0-9]{10,12}$/.test(ref) && BigInt(ref) >= 1000000001n ? 'memo-acp:8453:' + ref : 'erc8183:' + chain + ':' + ref;\n  return null;\n}\nfunction verdictFromDecision(d, composed) {\n  const rubric = /RUBRIC_v1 compose · rubric (0x[0-9a-f]{64})/.exec(String(d.note ?? ''));\n  const anchors = [];\n  if (d.anchor && isHash(d.anchor.tx)) anchors.push(chainAnchor(Number(d.anchor.chain), d.anchor.tx, `JevDecisionLog.record${d.anchor.index != null ? ` (decision index ${d.anchor.index})` : ''} · status ${d.anchor.status}`, { block: d.anchor.block ?? null, contract: d.anchor.contract ?? null }));\n  anchors.push({ kind: 'offchain', store: 'coordd:decisions', key: String(d.id), digest: isHash(d.digest) ? d.digest.toLowerCase() : null, anchored_by: anchors[0] && anchors[0].kind === 'chain' ? anchors[0] : null, what: 'the decision record; digest = sha256(canonicalDecision)' });\n  return {\n    schema: 'taifoon.verdict.v1', decision_id: String(d.id), version: d.v, kind: d.kind,\n    subject: { chain_id: Number(d.subject && d.subject.chainId), at: d.subject && d.subject.at ? String(d.subject.at).toLowerCase() : null, ref: String(d.subject && d.subject.ref), label: (d.subject && d.subject.label) ?? null },\n    subject_id: String(d.subject_id).toLowerCase(), subject_job_key: jobKeyOf(d.subject), digest: String(d.digest).toLowerCase(),\n    input_digest: isHash(d.input_digest) ? d.input_digest.toLowerCase() : null, answers_digest: isHash(d.answers_digest) ? d.answers_digest.toLowerCase() : null,\n    answers: (d.answers || []).map((a) => ({ id: String(a.id), question: a.question ?? null, options: a.options ?? null, value: String(a.value), probabilities: a.probabilities ?? {}, confidence: Number(a.confidence) })),\n    confidence_bps: d.confidence_bps, model: d.model ?? null, answers_source: d.answers_source ?? 'layer',\n    rubric: rubric ? { version: 'RUBRIC_v1', hash: rubric[1] } : null,\n    composed: composed ? { verdict: composed.verdict, auto: Boolean(composed.auto), forced: composed.forced ?? null, reasons: (composed.reasons || []).map(String), receipt_hash: isHash(composed.receiptHash) ? composed.receiptHash.toLowerCase() : null } : null,\n    anchors, source: { kind: 'decision', url: d.uri ?? `${SITE}/v1/judge/decisions/${d.id}`, read_at: Math.floor(Date.now() / 1000) },\n  };\n}\n// the GradeStampRegistry verdict code (1 delivered_as_specified · 2 delivered_with_defects · 3 not_delivered · 4 cannot_determine)\nconst STAMP_CODE = { delivered_as_specified: 1, delivered_with_defects: 2, not_delivered: 3, cannot_determine: 4 };\nfunction stampCodeOf(v) {\n  if (v.composed) return v.composed.verdict === 'complete' ? 1 : v.composed.verdict === 'reject' ? 2 : 4;\n  const ref = (v.answers || []).find((a) => STAMP_CODE[a.value]);\n  return ref ? STAMP_CODE[ref.value] : 4;\n}\n// the stamp transaction(s) the devnet signer mined → appended to the verdict's anchors\nconst stampAnchors = (sent, chainId) => (sent || []).filter((s) => isHash(s.tx) && s.status === 'success').map((s) => chainAnchor(chainId, s.tx, 'GradeStampRegistry.stamp (' + (s.action || 'stamp') + ')', { block: s.block ?? null, contract: s.to ?? null }));\n\n// the same VERDICT with the GradeStampRegistry stamp transaction appended to its anchors\nconst v = { ...$('Verdict').item.json };\ndelete v.stamp;\nreturn { json: { ...v, anchors: [...v.anchors, ...stampAnchors($json.sent, 36927)] } };"
       },
       "id": "bb65ea98-4d1f-4996-8498-b6a0a6c6c595",
       "name": "Verdict + stamp",

package/workflows/{0.1.0 → 0.2.1}/manifest.json

@@ -1,6 +1,6 @@
 {
-  "bundle": "jev-workflows-0.1.0",
-  "package": "@taifoon/jev@0.1.0",
+  "bundle": "jev-workflows-0.2.1",
+  "package": "@taifoon/jev@0.2.1",
   "workflows": [
     {
       "file": "hire-judge-settle.json",
@@ -29,7 +29,7 @@
       "file": "jev-grader.json",
       "source_id": "tfnjevgrader0001",
       "name": "Taifoon — Jev on-chain grader (grade → stamp → devnet)",
-      "sha256": "06159f5ee2ea51644d1cca6cbdc79024fb565bee0720e622f97e52a28652c98d",
+      "sha256": "762248c554dd0607362e20361ec3efe0fda58326d89c2f1c18c525ea48e92e35",
       "nodes": 11,
       "packages": [
         "n8n-nodes-taifoon",
@@ -72,7 +72,7 @@
       "file": "stamp-grade.json",
       "source_id": "tfnstamp00000001",
       "name": "Taifoon — Stamp Grade (a recorded verdict → GradeStampRegistry on the devnet)",
-      "sha256": "4464558aa9593b2bf3f2cbb6b95a0c7d2ab83c549947f96195322624da7028e4",
+      "sha256": "516d9483e3d26e1891dacb8c4493d609340e3c6a3b200784c72864f9cb931ebc",
       "nodes": 5,
       "packages": [
         "n8n-nodes-taifoon",
@@ -91,42 +91,42 @@
     {
       "file": "schemas/answers.json",
       "$id": "https://www.taifoon.io/schemas/coordination/v1/answers.json",
-      "sha256": "3b0aeda27c39da1bcdeba73fc787e43c30403b427cde5545211bbd0cb0488a98"
+      "sha256": "16dcdee34b631c22fc97a06bc79ac49045209b5a729fbcae851c7816ff5fd208"
     },
     {
       "file": "schemas/common.json",
       "$id": "https://www.taifoon.io/schemas/coordination/v1/common.json",
-      "sha256": "f878716e57b18f054cc0bed82a84d0c276e86ef03c00aff920a5ee9c9271867c"
+      "sha256": "d924619d04d607d1a07fd721c50ba61aa73523ffaac63b4459472d55c35e0da6"
     },
     {
       "file": "schemas/delivery.json",
       "$id": "https://www.taifoon.io/schemas/coordination/v1/delivery.json",
-      "sha256": "9c8adcc0e4c525dc750946de5c51cae51b0f513b85e760aa86e3254b8fde7e37"
+      "sha256": "21a24f9436e2e8bbe39d8285feb29777a4afab75c053d4fe1fb7d43996b36da0"
     },
     {
       "file": "schemas/facts.json",
       "$id": "https://www.taifoon.io/schemas/coordination/v1/facts.json",
-      "sha256": "d84e0fcbdf661c69dc6ee09a45603236749cbabae16107005a8b70d51d2401f1"
+      "sha256": "18c762ec1b35a819f302d73da293fd6c7320cb63bbbceb3a1d63143b1919e89f"
     },
     {
       "file": "schemas/hire.json",
       "$id": "https://www.taifoon.io/schemas/coordination/v1/hire.json",
-      "sha256": "3951cd490e0e72a5ecd7efe8ba6de71a829011660f57147e0b17ffe5f0bb1143"
+      "sha256": "a9cccbbce8f1b4f50c31769f7af63fa9fc086e452d537a1e78612ba39448fa18"
     },
     {
       "file": "schemas/job.json",
       "$id": "https://www.taifoon.io/schemas/coordination/v1/job.json",
-      "sha256": "12deb4119582da6e23229484d53e3fbd370becee6ef9a0bd31f1bec071701397"
+      "sha256": "c9fd5a4bcad766758b17dded08b877c047eaf51c318022bfa72aac45828ee357"
     },
     {
       "file": "schemas/settlement.json",
       "$id": "https://www.taifoon.io/schemas/coordination/v1/settlement.json",
-      "sha256": "6063c33c2739a416a01af90e0b38c63218437b955feb8e457b067f4351faa3cc"
+      "sha256": "50e7e12c6f4b076d6f2df36fa2aedac09130d274bac223bc2aa0ea8f768ba233"
     },
     {
       "file": "schemas/verdict.json",
       "$id": "https://www.taifoon.io/schemas/coordination/v1/verdict.json",
-      "sha256": "d8f5aee5a2e9c5146095c4061e3e463a232fda77f9031ba336959b70c906bd09"
+      "sha256": "4d80156faa135f28f5800f749a4f7ad8f22b72c422807a5254447032208b2942"
     }
   ],
   "packages": {

package/workflows/{0.1.0 → 0.2.1}/schemas/answers.json

@@ -8,29 +8,24 @@
     "schema": {
       "const": "taifoon.answers.v1",
       "x-stage": "L",
-      "x-source": "this contract",
       "description": "which canonical entity this record is; fixed per schema"
     },
     "answers_digest": {
       "$ref": "common.json#/$defs/bytes32",
-      "x-stage": "S5",
-      "x-source": "sha256(canonicalJson(record)) — JevAnswerLog answersDigest"
+      "x-stage": "S5"
     },
     "v": {
       "const": "jev.answer.v1",
-      "x-stage": "S5",
-      "x-source": "record version"
+      "x-stage": "S5"
     },
     "use_case": {
       "type": "string",
       "pattern": "^[a-z0-9][a-z0-9._/-]{0,63}$",
-      "x-stage": "S5",
-      "x-source": "ref · grade · compose · compose.answers · pad · suggest · assemble · study · registry.ref · runner.study · n8n.batch"
+      "x-stage": "S5"
     },
     "subject": {
       "$ref": "common.json#/$defs/bytes32",
-      "x-stage": "S5",
-      "x-source": "refBytes32(subject ref): a bytes32 passes through, anything else is keccak’d"
+      "x-stage": "S5"
     },
     "input_digest": {
       "anyOf": [
@@ -41,8 +36,7 @@
           "type": "null"
         }
       ],
-      "x-stage": "S5",
-      "x-source": "sha256 of exactly what Jev read"
+      "x-stage": "S5"
     },
     "questions": {
       "type": "array",
@@ -93,8 +87,7 @@
         ],
         "additionalProperties": false
       },
-      "x-stage": "S5",
-      "x-source": "the questions as asked"
+      "x-stage": "S5"
     },
     "answers": {
       "type": "array",
@@ -136,32 +129,28 @@
         "additionalProperties": false
       },
       "minItems": 1,
-      "x-stage": "S5",
-      "x-source": "value + the WHOLE distribution + confidence per question"
+      "x-stage": "S5"
     },
     "model": {
       "type": [
         "string",
         "null"
       ],
-      "x-stage": "S5",
-      "x-source": "model reported (jev-1.13.0)"
+      "x-stage": "S5"
     },
     "upstream_model": {
       "type": [
         "string",
         "null"
       ],
-      "x-stage": "S5",
-      "x-source": "upstream model"
+      "x-stage": "S5"
     },
     "latency_ms": {
       "type": [
         "integer",
         "null"
       ],
-      "x-stage": "S5",
-      "x-source": "model latency"
+      "x-stage": "S5"
     },
     "credential_path": {
       "enum": [
@@ -170,8 +159,7 @@
         "caller-credential",
         "registry"
       ],
-      "x-stage": "S5",
-      "x-source": "whose credential paid"
+      "x-stage": "S5"
     },
     "caller": {
       "enum": [
@@ -182,21 +170,18 @@
         "moonbeam",
         "runner"
       ],
-      "x-stage": "S5",
-      "x-source": "who asked"
+      "x-stage": "S5"
     },
     "at": {
       "$ref": "common.json#/$defs/unix_ms",
-      "x-stage": "S5",
-      "x-source": "ms since epoch"
+      "x-stage": "S5"
     },
     "decision_id": {
       "type": [
         "string",
         "null"
       ],
-      "x-stage": "S5",
-      "x-source": "the decision.v2 record these answers belong to"
+      "x-stage": "S5"
     },
     "decision_digest": {
       "anyOf": [
@@ -207,21 +192,18 @@
           "type": "null"
         }
       ],
-      "x-stage": "S5",
-      "x-source": "that decision’s digest (JevAnswerLog decisionDigest)"
+      "x-stage": "S5"
     },
     "anchors": {
       "type": "array",
       "items": {
         "$ref": "common.json#/$defs/anchor"
       },
-      "x-stage": "S6",
-      "x-source": "JevAnswerLog.record transaction (devnet 36927 0xD8c1…a8e3); coordd jevans:<digest>"
+      "x-stage": "S6"
     },
     "source": {
       "$ref": "common.json#/$defs/source",
-      "x-stage": "L",
-      "x-source": "the mapper"
+      "x-stage": "L"
     }
   },
   "required": [

package/workflows/{0.1.0 → 0.2.1}/schemas/common.json

@@ -367,7 +367,7 @@
             "evidence-pack",
             "job-classes"
           ],
-          "description": "which real source this record was mapped from (schemas/src/from/)"
+          "description": "which real source this record was mapped from"
         },
         "url": {
           "type": [