settld 0.1.2 → 0.2.0

package/docs/spec/examples/arbitration_case_v1.example.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": "ArbitrationCase.v1",
+  "caseId": "arb_case_20260207_0001",
+  "tenantId": "tenant_vectors",
+  "runId": "run_vectors_0001",
+  "settlementId": "setl_run_vectors_0001",
+  "disputeId": "dsp_run_vectors_0001",
+  "claimantAgentId": "agt_vectors_payer_0001",
+  "respondentAgentId": "agt_vectors_0001",
+  "arbiterAgentId": "agt_arbiter_0001",
+  "status": "under_review",
+  "openedAt": "2026-02-07T00:00:00.000Z",
+  "summary": "Claimant alleges SLA breach on two milestones.",
+  "evidenceRefs": [
+    "artifact://proof/run_vectors_0001/report.json",
+    "artifact://marketplace/agreements/run_vectors_0001.json"
+  ],
+  "appealRef": {
+    "parentCaseId": "arb_case_20260201_0099",
+    "parentVerdictId": "arb_verdict_20260202_0003",
+    "reason": "New evidence was submitted after initial verdict."
+  },
+  "revision": 2,
+  "createdAt": "2026-02-07T00:00:00.000Z",
+  "updatedAt": "2026-02-07T00:10:00.000Z"
+}

package/docs/spec/examples/arbitration_verdict_v1.example.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "ArbitrationVerdict.v1",
+  "verdictId": "arb_verdict_20260207_0001",
+  "caseId": "arb_case_20260207_0001",
+  "tenantId": "tenant_vectors",
+  "runId": "run_vectors_0001",
+  "settlementId": "setl_run_vectors_0001",
+  "disputeId": "dsp_run_vectors_0001",
+  "arbiterAgentId": "agt_arbiter_0001",
+  "outcome": "partial",
+  "releaseRatePct": 60,
+  "rationale": "Evidence confirms partial completion; release 60% and refund the remainder.",
+  "evidenceRefs": [
+    "artifact://proof/run_vectors_0001/report.json",
+    "artifact://marketplace/disputes/dsp_run_vectors_0001/evidence_02.json"
+  ],
+  "issuedAt": "2026-02-07T00:15:00.000Z",
+  "appealRef": {
+    "appealCaseId": "arb_case_20260208_0002",
+    "parentVerdictId": "arb_verdict_20260206_0012",
+    "reason": "Parent verdict superseded after formal appeal filing."
+  },
+  "signature": {
+    "algorithm": "ed25519",
+    "signerKeyId": "key_arbiter_0001",
+    "verdictHash": "4e6b2475878aafaef42d0cb94d8e631f932db09957ea72a6f9a34753220d4fcb",
+    "signature": "m4q2iD6n5J9rL6QmFJ2x0vQfV0dN0uU1V3V9M3rG8yN7n5TzB2W4p0m8l7Qx2k9h5x6j8m1r9p4s2t6u0v3w=="
+  },
+  "revision": 1,
+  "createdAt": "2026-02-07T00:15:00.000Z",
+  "updatedAt": "2026-02-07T00:15:00.000Z"
+}

package/docs/spec/examples/dispute_open_envelope_v1.example.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": "DisputeOpenEnvelope.v1",
+  "artifactType": "DisputeOpenEnvelope.v1",
+  "artifactId": "dopen_tc_1111111111111111111111111111111111111111111111111111111111111111",
+  "envelopeId": "dopen_tc_1111111111111111111111111111111111111111111111111111111111111111",
+  "caseId": "arb_case_tc_1111111111111111111111111111111111111111111111111111111111111111",
+  "tenantId": "tenant_default",
+  "agreementHash": "1111111111111111111111111111111111111111111111111111111111111111",
+  "receiptHash": "2222222222222222222222222222222222222222222222222222222222222222",
+  "holdHash": "3333333333333333333333333333333333333333333333333333333333333333",
+  "openedByAgentId": "agt_demo_payee_1",
+  "openedAt": "2026-02-11T12:00:00.000Z",
+  "reasonCode": "TOOL_CALL_DISPUTE",
+  "nonce": "nonce_demo_00000001",
+  "signerKeyId": "key_demo_signer_0001",
+  "envelopeHash": "6dac9a886bf7466dd5faa57aef1a033ad4d41d9f8176d755f4a5fb9e26271cf4",
+  "signature": "sig_demo_base64_0001"
+}

package/docs/spec/examples/produce_cli_output_v1.example.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "ProduceCliOutput.v1",
+  "tool": {
+    "name": "settld",
+    "version": "0.0.0",
+    "commit": "0123456789abcdef0123456789abcdef01234567"
+  },
+  "mode": {
+    "deterministic": true,
+    "now": "1970-01-01T00:00:00.000Z"
+  },
+  "target": {
+    "kind": "jobproof",
+    "out": "/tmp/out/bundle"
+  },
+  "ok": true,
+  "produceOk": true,
+  "warnings": [],
+  "errors": [],
+  "result": {
+    "bundleDir": "/tmp/out/bundle",
+    "type": "JobProofBundle.v1",
+    "tenantId": "tenant_default",
+    "jobId": "job_default",
+    "period": null,
+    "basis": null,
+    "protocol": null,
+    "manifestHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+    "attestationHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
+  }
+}
+

package/docs/spec/examples/release_index_signature_v1.example.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": "ReleaseIndexSignature.v1",
+  "algorithm": "ed25519-sha256",
+  "keyId": "key_example",
+  "messageSha256": "0000000000000000000000000000000000000000000000000000000000000000",
+  "publicKeyPem": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEA0000000000000000000000000000000000000000000=\n-----END PUBLIC KEY-----\n",
+  "signatureBase64": "AAAA"
+}
+

package/docs/spec/examples/release_index_signatures_v1.example.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": "ReleaseIndexSignatures.v1",
+  "signatures": [
+    {
+      "schemaVersion": "ReleaseIndexSignature.v1",
+      "algorithm": "ed25519-sha256",
+      "keyId": "key_example_a",
+      "messageSha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "publicKeyPem": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa=\n-----END PUBLIC KEY-----\n",
+      "signatureBase64": "AA=="
+    }
+  ]
+}
+

package/docs/spec/examples/release_index_v1.example.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": "ReleaseIndex.v1",
+  "release": { "tag": "v1.0.0", "version": "1.0.0" },
+  "toolchain": {
+    "commit": "0123456789abcdef0123456789abcdef01234567",
+    "buildEpochSeconds": 0,
+    "canonicalJson": "RFC8785",
+    "includedSchemas": ["VerifyCliOutput.v1", "ProduceCliOutput.v1", "ReleaseIndex.v1"]
+  },
+  "artifacts": [
+    { "path": "settld-artifact-verify-1.0.0.tgz", "sha256": "0000000000000000000000000000000000000000000000000000000000000000", "sizeBytes": 0, "kind": "npm-tgz" },
+    { "path": "conformance-v1.tar.gz", "sha256": "0000000000000000000000000000000000000000000000000000000000000000", "sizeBytes": 0, "kind": "conformance" }
+  ]
+}
+

package/docs/spec/examples/release_trust_v1.example.json

@@ -0,0 +1,7 @@
+{
+  "schemaVersion": "ReleaseTrust.v1",
+  "releaseRoots": {
+    "key_example": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEA0000000000000000000000000000000000000000000=\n-----END PUBLIC KEY-----\n"
+  }
+}
+

package/docs/spec/examples/release_trust_v2.example.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": "ReleaseTrust.v2",
+  "policy": {
+    "minSignatures": 2,
+    "requiredKeyIds": ["key_example_a"]
+  },
+  "keys": [
+    {
+      "keyId": "key_example_a",
+      "publicKeyPem": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa=\n-----END PUBLIC KEY-----\n",
+      "notBeforeEpochSeconds": 0,
+      "comment": "example root A"
+    },
+    {
+      "keyId": "key_example_b",
+      "publicKeyPem": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb=\n-----END PUBLIC KEY-----\n",
+      "notBeforeEpochSeconds": 0,
+      "comment": "example root B"
+    }
+  ]
+}
+

package/docs/spec/examples/remote_signer_request_v1.example.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": "RemoteSignerRequest.v1",
+  "op": "sign",
+  "body": {
+    "schemaVersion": "RemoteSignerSignRequest.v1",
+    "requestId": "req_00000001",
+    "keyId": "key_example",
+    "algorithm": "ed25519",
+    "messageBase64": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
+    "purpose": "bundle_head_attestation",
+    "context": {
+      "bundleKind": "JobProofBundle.v1",
+      "tenantId": "tenant_example",
+      "manifestHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
+    }
+  }
+}
+

package/docs/spec/examples/remote_signer_response_v1.example.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": "RemoteSignerSignResponse.v1",
+  "requestId": "req_00000001",
+  "keyId": "key_example",
+  "algorithm": "ed25519",
+  "signatureBase64": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
+  "signerReceipt": "example-receipt"
+}

package/docs/spec/examples/reputation_event_v1.example.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "ReputationEvent.v1",
+  "artifactType": "ReputationEvent.v1",
+  "artifactId": "rep_vrd_6ed7af4431923f9cb4ff8f8f0af36ac168f991f3f9f7f0f3f9ff3f0f9af3f8c9",
+  "eventId": "rep_vrd_6ed7af4431923f9cb4ff8f8f0af36ac168f991f3f9f7f0f3f9ff3f0f9af3f8c9",
+  "tenantId": "tenant_default",
+  "occurredAt": "2026-02-11T12:00:00.000Z",
+  "eventKind": "verdict_issued",
+  "subject": {
+    "agentId": "agt_payee_demo",
+    "toolId": "tool_call",
+    "counterpartyAgentId": "agt_payer_demo",
+    "role": "payee"
+  },
+  "sourceRef": {
+    "kind": "arbitration_verdict",
+    "artifactId": "arbitration_verdict_avd_demo",
+    "agreementHash": "1111111111111111111111111111111111111111111111111111111111111111",
+    "verdictHash": "6ed7af4431923f9cb4ff8f8f0af36ac168f991f3f9f7f0f3f9ff3f0f9af3f8c9",
+    "disputeId": "disp_tc_deadbeef",
+    "caseId": "arb_case_tc_deadbeef"
+  },
+  "facts": {
+    "verdictOutcome": "payee_win",
+    "releaseRatePct": 100,
+    "amountCents": 2000
+  },
+  "eventHash": "6c48dc294a69413fe9f4548ef25319c3c73396018249b1667eb52447c3ecba63"
+}

package/docs/spec/examples/verification_report_v1.example.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": "VerificationReport.v1",
+  "profile": "strict",
+  "tool": { "name": "settld", "version": "0.0.0-example", "commit": "0123456789abcdef0123456789abcdef01234567" },
+  "warnings": [],
+  "signer": { "keyId": "key_example", "scope": "global", "governanceEventRef": null },
+  "bundleHeadAttestation": {
+    "schemaVersion": "BundleHeadAttestation.v1",
+    "attestationHash": "0000000000000000000000000000000000000000000000000000000000000000",
+    "signerKeyId": "key_example",
+    "signedAt": "2026-01-01T00:00:00.000Z",
+    "manifestHash": "0000000000000000000000000000000000000000000000000000000000000000"
+  },
+  "subject": {
+    "type": "JobProofBundle.v1",
+    "tenantId": "tenant_example",
+    "createdAt": "2026-01-01T00:00:00.000Z",
+    "manifestHash": "0000000000000000000000000000000000000000000000000000000000000000"
+  },
+  "reportHash": "0000000000000000000000000000000000000000000000000000000000000000",
+  "signature": null,
+  "signerKeyId": null,
+  "signedAt": null
+}

package/docs/spec/examples/verify_about_output_v1.example.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "VerifyAboutOutput.v1",
+  "tool": {
+    "name": "settld-verify",
+    "version": "0.0.0",
+    "commit": "0123456789abcdef"
+  },
+  "protocol": {
+    "canonicalJson": "RFC8785",
+    "objects": [
+      "ProofBundleManifest.v1",
+      "FinancePackBundleManifest.v1",
+      "BundleHeadAttestation.v1",
+      "VerificationReport.v1",
+      "VerifyCliOutput.v1",
+      "VerifyAboutOutput.v1"
+    ]
+  },
+  "defaults": {
+    "strict": false,
+    "hashConcurrency": 16
+  },
+  "features": {
+    "format": ["human", "json"],
+    "failOnWarnings": true,
+    "hashConcurrency": true
+  }
+}
+

package/docs/spec/examples/verify_cli_output_v1.example.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": "VerifyCliOutput.v1",
+  "tool": { "name": "settld-verify", "version": "0.0.0", "commit": "0123456789abcdef0123456789abcdef01234567" },
+  "mode": { "strict": false, "failOnWarnings": false },
+  "target": { "kind": "job-proof", "input": "/path/to/bundle", "resolved": "/path/to/bundle", "dir": "/path/to/bundle" },
+  "ok": true,
+  "verificationOk": true,
+  "errors": [],
+  "warnings": [
+    { "code": "VERIFICATION_REPORT_MISSING_LENIENT", "path": "verify/verification_report.json", "message": null, "detail": null }
+  ],
+  "summary": { "tenantId": "tenant_default", "period": null, "type": "JobProofBundle.v1", "manifestHash": "0000000000000000000000000000000000000000000000000000000000000000" }
+}

package/docs/spec/legacy/MarketplaceAcceptance.v1.md

@@ -0,0 +1,48 @@
+# MarketplaceAcceptance.v1
+
+Legacy note: `MarketplaceAcceptance.v1` is retained for historical artifacts only. New integrations should use `MarketplaceAcceptance.v2` (`rfqId` field) and treat `v1` as read-only.
+
+`MarketplaceAcceptance.v1` is the canonical acceptance artifact for one selected `MarketplaceOffer.v1`.
+
+It binds acceptance metadata (`acceptedBy`, proposal identity, chain hash, counts) to a stable `offerRef` (`offerId`, `offerHash`) and emits `acceptanceHash`.
+
+## Purpose
+
+- make acceptance independently replayable from the agreement envelope;
+- explicitly bind acceptance to a hashed offer artifact;
+- provide a stable acceptance hash for signatures/audit and downstream dispute traces.
+
+## Required fields
+
+- `schemaVersion` (const: `MarketplaceAcceptance.v1`)
+- `acceptanceId`
+- `tenantId`
+- `taskId`
+- `runId`
+- `bidId`
+- `acceptedAt`
+- `acceptedByAgentId`
+- `acceptedProposalId`
+- `acceptedRevision`
+- `acceptedProposalHash`
+- `offerChainHash`
+- `proposalCount`
+- `offerRef` (`offerId`, `offerHash`)
+- `createdAt`
+- `acceptanceHash`
+
+Optional fields:
+
+- `agreementId`
+
+## Canonicalization and hashing
+
+`acceptanceHash` is computed over canonical JSON after removing `acceptanceHash`:
+
+1. canonicalize JSON with RFC 8785 (JCS),
+2. hash canonical UTF-8 bytes using `sha256`,
+3. encode as lowercase hex.
+
+## Schema
+
+See `schemas/MarketplaceAcceptance.v1.schema.json`.

package/docs/spec/legacy/MarketplaceOffer.v1.md

@@ -0,0 +1,56 @@
+# MarketplaceOffer.v1
+
+Legacy note: `MarketplaceOffer.v1` is retained for historical artifacts only. New integrations should use `MarketplaceOffer.v2` (`rfqId` field) and treat `v1` as read-only.
+
+`MarketplaceOffer.v1` is the canonical pre-contract offer artifact derived from a `MarketplaceBidProposal.v1` chain.
+
+It freezes the selected proposal terms before agreement acceptance so downstream systems can bind acceptance, signatures, and settlement to one immutable offer hash.
+
+## Purpose
+
+- separate pre-contract offer state from agreement state;
+- make accepted proposal terms portable and replayable;
+- provide a stable `offerHash` anchor for `MarketplaceAcceptance.v1`.
+
+## Required fields
+
+- `schemaVersion` (const: `MarketplaceOffer.v1`)
+- `offerId`
+- `tenantId`
+- `taskId`
+- `bidId`
+- `revision`
+- `amountCents`
+- `currency`
+- `proposalHash`
+- `proposedAt`
+- `createdAt`
+- `offerHash`
+
+Optional fields:
+
+- `runId`
+- `proposalId`
+- `proposerAgentId`
+- `etaSeconds`
+- `note`
+- `verificationMethod`
+- `policy`
+- `policyRef`
+- `policyRefHash`
+- `prevProposalHash`
+- `offerChainHash`
+- `proposalCount`
+- `metadata`
+
+## Canonicalization and hashing
+
+`offerHash` is computed over canonical JSON after removing `offerHash`:
+
+1. canonicalize JSON with RFC 8785 (JCS),
+2. hash canonical UTF-8 bytes using `sha256`,
+3. encode as lowercase hex.
+
+## Schema
+
+See `schemas/MarketplaceOffer.v1.schema.json`.

package/docs/spec/legacy/schemas/MarketplaceAcceptance.v1.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/MarketplaceAcceptance.v1.schema.json",
+  "title": "MarketplaceAcceptance.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "acceptanceId",
+    "tenantId",
+    "taskId",
+    "runId",
+    "bidId",
+    "agreementId",
+    "acceptedAt",
+    "acceptedByAgentId",
+    "acceptedProposalId",
+    "acceptedRevision",
+    "acceptedProposalHash",
+    "offerChainHash",
+    "proposalCount",
+    "offerRef",
+    "createdAt",
+    "acceptanceHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "MarketplaceAcceptance.v1" },
+    "acceptanceId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "taskId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "runId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "bidId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "agreementId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "acceptedAt": { "type": ["string", "null"], "format": "date-time" },
+    "acceptedByAgentId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "acceptedProposalId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "acceptedRevision": { "type": ["integer", "null"], "minimum": 1 },
+    "acceptedProposalHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "offerChainHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "proposalCount": { "type": ["integer", "null"], "minimum": 1 },
+    "offerRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["offerId", "offerHash"],
+      "properties": {
+        "offerId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+        "offerHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "acceptanceHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}

package/docs/spec/legacy/schemas/MarketplaceOffer.v1.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/MarketplaceOffer.v1.schema.json",
+  "title": "MarketplaceOffer.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "offerId",
+    "tenantId",
+    "taskId",
+    "runId",
+    "bidId",
+    "proposalId",
+    "revision",
+    "proposerAgentId",
+    "amountCents",
+    "currency",
+    "etaSeconds",
+    "note",
+    "verificationMethod",
+    "policy",
+    "policyRef",
+    "policyRefHash",
+    "prevProposalHash",
+    "proposalHash",
+    "offerChainHash",
+    "proposalCount",
+    "metadata",
+    "proposedAt",
+    "createdAt",
+    "offerHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "MarketplaceOffer.v1" },
+    "offerId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "taskId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "runId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "bidId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "proposalId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "revision": { "type": "integer", "minimum": 1 },
+    "proposerAgentId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "amountCents": { "type": "integer", "minimum": 1 },
+    "currency": { "type": "string", "minLength": 3, "maxLength": 12, "pattern": "^[A-Z][A-Z0-9_]{2,11}$" },
+    "etaSeconds": { "type": ["integer", "null"], "minimum": 1 },
+    "note": { "type": ["string", "null"], "maxLength": 4000 },
+    "verificationMethod": { "type": ["object", "null"], "additionalProperties": true },
+    "policy": { "type": ["object", "null"], "additionalProperties": true },
+    "policyRef": { "type": ["object", "null"], "additionalProperties": true },
+    "policyRefHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "prevProposalHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "proposalHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "offerChainHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "proposalCount": { "type": ["integer", "null"], "minimum": 1 },
+    "metadata": { "type": ["object", "null"], "additionalProperties": true },
+    "proposedAt": { "type": "string", "format": "date-time" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "offerHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}

package/docs/spec/producer-error-codes.v1.txt

@@ -0,0 +1,14 @@
+PRODUCE_FAILED
+SIGNER_AUTH_FAILED
+SIGNER_AUTH_MISSING
+SIGNER_BAD_RESPONSE
+SIGNER_MESSAGE_TOO_LARGE
+SIGNER_PLUGIN_INIT_FAILED
+SIGNER_PLUGIN_INVALID_PROVIDER
+SIGNER_PLUGIN_LOAD_FAILED
+SIGNER_PLUGIN_MISSING_EXPORT
+SIGNER_RESPONSE_TOO_LARGE
+SIGNER_TIMEOUT
+SIGNER_UNREACHABLE
+VERIFY_AFTER_FAILED
+

package/docs/spec/schemas/AcceptanceCriteria.v1.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AcceptanceCriteria.v1.schema.json",
+  "title": "AcceptanceCriteria.v1",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "criteria"],
+  "properties": {
+    "schemaVersion": { "const": "AcceptanceCriteria.v1" },
+    "generatedAt": { "type": "string" },
+    "criteria": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["criterionId", "kind"],
+        "properties": {
+          "criterionId": { "type": "string" },
+          "kind": { "enum": ["PROOF_STATUS_EQUALS", "SLA_OVERALL_OK"] },
+          "expectedStatus": { "type": "string" }
+        }
+      }
+    }
+  }
+}
+

package/docs/spec/schemas/AcceptanceEvaluation.v1.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AcceptanceEvaluation.v1.schema.json",
+  "title": "AcceptanceEvaluation.v1",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "overallStatus", "results"],
+  "properties": {
+    "schemaVersion": { "const": "AcceptanceEvaluation.v1" },
+    "generatedAt": { "type": "string" },
+    "overallStatus": { "enum": ["ok", "fail", "unknown"] },
+    "results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["criterionId", "kind", "status", "detail"],
+        "properties": {
+          "criterionId": { "type": "string" },
+          "kind": { "type": "string" },
+          "status": { "enum": ["ok", "fail", "unknown"] },
+          "detail": {}
+        }
+      }
+    }
+  }
+}
+