settld 0.1.2 → 0.2.0

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

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/MeteringReport.v1.schema.json",
+  "title": "MeteringReport.v1",
+  "type": "object",
+  "required": ["schemaVersion", "tenantId", "invoiceId", "generatedAt", "jobProof", "items", "evidenceRefs"],
+  "properties": {
+    "schemaVersion": { "const": "MeteringReport.v1" },
+    "tenantId": { "type": "string" },
+    "invoiceId": { "type": "string" },
+    "generatedAt": { "type": "string" },
+    "jobProof": {
+      "type": "object",
+      "required": ["embeddedPath", "manifestHash", "headAttestationHash"],
+      "properties": {
+        "embeddedPath": { "const": "payload/job_proof_bundle" },
+        "manifestHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "headAttestationHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "quantity"],
+        "properties": {
+          "code": { "type": "string" },
+          "quantity": { "type": "string", "pattern": "^[0-9]+$" }
+        }
+      }
+    },
+    "evidenceRefs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "sha256"],
+        "properties": {
+          "path": { "type": "string" },
+          "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+        }
+      }
+    }
+  }
+}
+

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

@@ -0,0 +1,113 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/OperatorAction.v1.schema.json",
+  "title": "OperatorAction.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "caseRef",
+    "action",
+    "justificationCode",
+    "actor",
+    "actedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OperatorAction.v1" },
+    "actionId": {
+      "type": "string",
+      "maxLength": 240,
+      "pattern": "^[A-Za-z0-9:._/-]+$"
+    },
+    "caseRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "caseId"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": ["challenge", "dispute", "escalation"]
+        },
+        "caseId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240,
+          "pattern": "^[A-Za-z0-9:._/-]+$"
+        }
+      }
+    },
+    "action": {
+      "type": "string",
+      "enum": ["APPROVE", "REJECT", "REQUEST_INFO", "OVERRIDE_ALLOW", "OVERRIDE_DENY"]
+    },
+    "justificationCode": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Z][A-Z0-9._:-]*$"
+    },
+    "justification": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000
+    },
+    "actor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operatorId"],
+      "properties": {
+        "operatorId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200,
+          "pattern": "^[A-Za-z0-9:._/-]+$"
+        },
+        "role": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[a-z0-9._:-]+$"
+        },
+        "tenantId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9:._/-]+$"
+        },
+        "sessionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256,
+          "pattern": "^[A-Za-z0-9:._/-]+$"
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "actedAt": { "type": "string", "format": "date-time" },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "signature": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "algorithm", "keyId", "signedAt", "actionHash", "signatureBase64"],
+      "properties": {
+        "schemaVersion": { "const": "OperatorActionSignature.v1" },
+        "algorithm": { "const": "ed25519" },
+        "keyId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256,
+          "pattern": "^[A-Za-z0-9:._/-]+$"
+        },
+        "actionHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "signatureBase64": { "type": "string", "minLength": 1, "maxLength": 16384 },
+        "signedAt": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/PolicyDecision.v1.schema.json",
+  "title": "PolicyDecision.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "decisionId",
+    "tenantId",
+    "runId",
+    "settlementId",
+    "policyRef",
+    "decisionMode",
+    "verificationStatus",
+    "runStatus",
+    "shouldAutoResolve",
+    "settlementStatus",
+    "releaseRatePct",
+    "releaseAmountCents",
+    "refundAmountCents",
+    "reasonCodes",
+    "evaluationHash",
+    "createdAt",
+    "policyDecisionHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "PolicyDecision.v1" },
+    "decisionId": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "runId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "settlementId": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "gateId": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "policyRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policyId", "policyVersion", "policyHash", "verificationMethodHash"],
+      "properties": {
+        "policyId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" },
+        "policyVersion": { "type": ["integer", "null"], "minimum": 1 },
+        "policyHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "verificationMethodHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "decisionMode": { "type": "string", "enum": ["automatic", "manual-review"] },
+    "verificationStatus": { "type": "string", "minLength": 1, "maxLength": 32, "pattern": "^[a-z0-9_-]+$" },
+    "runStatus": { "type": "string", "minLength": 1, "maxLength": 32, "pattern": "^[a-z0-9_-]+$" },
+    "shouldAutoResolve": { "type": "boolean" },
+    "settlementStatus": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9_-]+$" },
+    "releaseRatePct": { "type": "integer", "minimum": 0, "maximum": 100 },
+    "releaseAmountCents": { "type": "integer", "minimum": 0 },
+    "refundAmountCents": { "type": "integer", "minimum": 0 },
+    "reasonCodes": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" },
+      "uniqueItems": true
+    },
+    "evaluationHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "metadata": { "type": "object", "additionalProperties": true },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "policyDecisionHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "signature": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["algorithm", "signerKeyId", "policyDecisionHash", "signature"],
+      "properties": {
+        "algorithm": { "const": "ed25519" },
+        "signerKeyId": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[A-Za-z0-9:_-]+$" },
+        "policyDecisionHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "signature": { "type": "string", "minLength": 1, "maxLength": 16384 }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/PricingMatrix.v1.schema.json",
+  "title": "PricingMatrix.v1",
+  "type": "object",
+  "required": ["schemaVersion", "currency", "prices"],
+  "properties": {
+    "schemaVersion": { "const": "PricingMatrix.v1" },
+    "currency": { "type": "string" },
+    "prices": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "unitPriceCents"],
+        "properties": {
+          "code": { "type": "string" },
+          "unitPriceCents": { "type": "string", "pattern": "^[0-9]+$" }
+        }
+      }
+    },
+    "generatedAt": { "type": ["string", "null"] }
+  }
+}
+

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

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/PricingMatrixSignatures.v1.schema.json",
+  "title": "PricingMatrixSignatures.v1",
+  "type": "object",
+  "required": ["schemaVersion", "pricingMatrixHash", "signatures"],
+  "properties": {
+    "schemaVersion": { "const": "PricingMatrixSignatures.v1" },
+    "pricingMatrixHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "signatures": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["signerKeyId", "signedAt", "signature"],
+        "properties": {
+          "signerKeyId": { "type": "string" },
+          "signedAt": { "type": "string" },
+          "signature": { "type": "string" }
+        }
+      }
+    }
+  }
+}
+

package/docs/spec/schemas/PricingMatrixSignatures.v2.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/PricingMatrixSignatures.v2.schema.json",
+  "title": "PricingMatrixSignatures.v2",
+  "type": "object",
+  "required": ["schemaVersion", "pricingMatrixCanonicalHash", "signatures"],
+  "properties": {
+    "schemaVersion": { "const": "PricingMatrixSignatures.v2" },
+    "pricingMatrixCanonicalHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "signatures": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["signerKeyId", "signedAt", "signature"],
+        "properties": {
+          "signerKeyId": { "type": "string" },
+          "signedAt": { "type": "string" },
+          "signature": { "type": "string" }
+        }
+      }
+    }
+  }
+}
+

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

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ProduceCliOutput.v1.schema.json",
+  "title": "ProduceCliOutput.v1",
+  "type": "object",
+  "required": ["schemaVersion", "tool", "mode", "target", "ok", "produceOk", "errors", "warnings", "result"],
+  "properties": {
+    "schemaVersion": { "const": "ProduceCliOutput.v1" },
+    "tool": {
+      "type": "object",
+      "required": ["name", "version"],
+      "properties": {
+        "name": { "type": "string" },
+        "version": { "type": ["string", "null"] },
+        "commit": { "type": ["string", "null"], "pattern": "^[0-9a-f]{7,64}$" }
+      }
+    },
+    "mode": {
+      "type": "object",
+      "required": ["deterministic", "now"],
+      "properties": {
+        "deterministic": { "type": "boolean" },
+        "now": { "type": ["string", "null"] }
+      }
+    },
+    "target": {
+      "type": "object",
+      "required": ["kind", "out"],
+      "properties": {
+        "kind": { "type": ["string", "null"] },
+        "out": { "type": ["string", "null"] }
+      }
+    },
+    "ok": { "type": "boolean" },
+    "produceOk": { "type": "boolean" },
+    "verifyAfter": {
+      "type": "object",
+      "required": ["ok", "exitCode", "output"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "exitCode": { "type": "integer" },
+        "output": {}
+      }
+    },
+    "errors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "path", "message", "detail"],
+        "properties": {
+          "code": { "type": "string" },
+          "causeKind": {
+            "type": "string",
+            "enum": ["signer", "plugin", "verify", "input", "io", "internal"]
+          },
+          "causeCode": { "type": "string" },
+          "path": { "type": ["string", "null"] },
+          "message": { "type": ["string", "null"] },
+          "detail": {}
+        }
+      }
+    },
+    "warnings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "path", "message", "detail"],
+        "properties": {
+          "code": { "type": "string" },
+          "causeKind": {
+            "type": "string",
+            "enum": ["signer", "plugin", "verify", "input", "io", "internal"]
+          },
+          "causeCode": { "type": "string" },
+          "path": { "type": ["string", "null"] },
+          "message": { "type": ["string", "null"] },
+          "detail": {}
+        }
+      }
+    },
+    "result": {
+      "type": ["object", "null"],
+      "required": [
+        "bundleDir",
+        "type",
+        "tenantId",
+        "jobId",
+        "period",
+        "basis",
+        "protocol",
+        "manifestHash",
+        "attestationHash"
+      ],
+      "properties": {
+        "bundleDir": { "type": ["string", "null"] },
+        "type": { "type": ["string", "null"] },
+        "tenantId": { "type": ["string", "null"] },
+        "jobId": { "type": ["string", "null"] },
+        "period": { "type": ["string", "null"] },
+        "basis": { "type": ["string", "null"] },
+        "protocol": { "type": ["string", "null"] },
+        "manifestHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+        "attestationHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ProofBundleManifest.v1.schema.json",
+  "title": "ProofBundleManifest.v1",
+  "type": "object",
+  "required": ["schemaVersion", "kind", "tenantId", "scope", "generatedAt", "hashing", "files"],
+  "properties": {
+    "schemaVersion": { "const": "ProofBundleManifest.v1" },
+    "kind": { "type": "string" },
+    "tenantId": { "type": "string" },
+    "scope": { "type": "object" },
+    "generatedAt": { "type": "string" },
+    "hashing": {
+      "type": "object",
+      "required": ["schemaVersion", "fileOrder", "excludes"],
+      "properties": {
+        "schemaVersion": { "const": "ProofBundleManifestHash.v1" },
+        "fileOrder": { "const": "path_asc" },
+        "excludes": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "sha256", "bytes"],
+        "properties": {
+          "name": { "type": "string" },
+          "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "bytes": { "type": "integer", "minimum": 0 }
+        }
+      }
+    },
+    "manifestHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}
+

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

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/PublicKeys.v1.schema.json",
+  "title": "PublicKeys.v1",
+  "type": "object",
+  "required": ["schemaVersion", "tenantId", "generatedAt", "order", "keys"],
+  "properties": {
+    "schemaVersion": { "const": "PublicKeys.v1" },
+    "tenantId": { "type": "string" },
+    "generatedAt": { "type": "string" },
+    "order": { "const": "keyId_asc" },
+    "keys": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["keyId", "publicKeyPem"],
+        "properties": {
+          "keyId": { "type": "string" },
+          "publicKeyPem": { "type": "string" },
+          "tenantId": { "type": ["string", "null"] },
+          "purpose": { "type": ["string", "null"], "enum": ["robot", "operator", "server", null] },
+          "status": { "type": ["string", "null"] },
+          "description": { "type": ["string", "null"] },
+          "validFrom": { "type": ["string", "null"] },
+          "validTo": { "type": ["string", "null"] },
+          "createdAt": { "type": ["string", "null"] },
+          "rotatedAt": { "type": ["string", "null"] },
+          "revokedAt": { "type": ["string", "null"] }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ReleaseIndex.v1.schema.json",
+  "title": "ReleaseIndex.v1",
+  "type": "object",
+  "required": ["schemaVersion", "release", "toolchain", "artifacts"],
+  "properties": {
+    "schemaVersion": { "const": "ReleaseIndex.v1" },
+    "release": {
+      "type": "object",
+      "required": ["tag", "version"],
+      "properties": {
+        "tag": { "type": "string" },
+        "version": { "type": "string" }
+      }
+    },
+    "toolchain": {
+      "type": "object",
+      "required": ["commit"],
+      "properties": {
+        "commit": { "type": ["string", "null"], "pattern": "^[0-9a-f]{7,64}$" },
+        "buildEpochSeconds": { "type": ["integer", "null"], "minimum": 0 },
+        "canonicalJson": { "type": "string" },
+        "includedSchemas": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "sha256", "sizeBytes"],
+        "properties": {
+          "path": { "type": "string" },
+          "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "sizeBytes": { "type": "integer", "minimum": 0 },
+          "kind": { "type": ["string", "null"] }
+        }
+      }
+    }
+  }
+}
+

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

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ReleaseIndexSignature.v1.schema.json",
+  "title": "ReleaseIndexSignature.v1",
+  "type": "object",
+  "required": ["schemaVersion", "algorithm", "messageSha256", "publicKeyPem", "signatureBase64"],
+  "properties": {
+    "schemaVersion": { "const": "ReleaseIndexSignature.v1" },
+    "algorithm": { "const": "ed25519-sha256" },
+    "keyId": { "type": ["string", "null"] },
+    "messageSha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "publicKeyPem": { "type": "string" },
+    "signatureBase64": { "type": "string", "pattern": "^[A-Za-z0-9+/=]+$" }
+  }
+}
+

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

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ReleaseIndexSignatures.v1.schema.json",
+  "title": "ReleaseIndexSignatures.v1",
+  "type": "object",
+  "required": ["schemaVersion", "signatures"],
+  "properties": {
+    "schemaVersion": { "const": "ReleaseIndexSignatures.v1" },
+    "signatures": {
+      "type": "array",
+      "items": { "$ref": "https://settld.local/schemas/ReleaseIndexSignature.v1.schema.json" },
+      "minItems": 1
+    }
+  }
+}
+

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

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ReleaseTrust.v1.schema.json",
+  "title": "ReleaseTrust.v1",
+  "type": "object",
+  "required": ["schemaVersion", "releaseRoots"],
+  "properties": {
+    "schemaVersion": { "const": "ReleaseTrust.v1" },
+    "releaseRoots": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    }
+  }
+}
+

package/docs/spec/schemas/ReleaseTrust.v2.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ReleaseTrust.v2.schema.json",
+  "title": "ReleaseTrust.v2",
+  "type": "object",
+  "required": ["schemaVersion", "policy", "keys"],
+  "properties": {
+    "schemaVersion": { "const": "ReleaseTrust.v2" },
+    "policy": {
+      "type": "object",
+      "required": ["minSignatures"],
+      "properties": {
+        "minSignatures": { "type": "integer", "minimum": 1 },
+        "requiredKeyIds": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "keys": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["keyId", "publicKeyPem"],
+        "properties": {
+          "keyId": { "type": "string" },
+          "publicKeyPem": { "type": "string" },
+          "notBeforeEpochSeconds": { "type": "integer", "minimum": 0 },
+          "notAfterEpochSeconds": { "type": "integer", "minimum": 0 },
+          "revokedAtEpochSeconds": { "type": "integer", "minimum": 0 },
+          "comment": { "type": "string" }
+        }
+      }
+    }
+  }
+}
+

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

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/RemoteSignerPublicKeyResponse.v1.schema.json",
+  "title": "RemoteSignerPublicKeyResponse.v1",
+  "type": "object",
+  "required": ["schemaVersion", "keyId", "algorithm", "publicKeyPem"],
+  "properties": {
+    "schemaVersion": { "const": "RemoteSignerPublicKeyResponse.v1" },
+    "keyId": { "type": "string" },
+    "algorithm": { "enum": ["ed25519"] },
+    "publicKeyPem": { "type": "string" }
+  }
+}
+