enigma-memory 0.1.0

package/specs/production-handoff-packet-v1.schema.json

@@ -0,0 +1,149 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://enigma.memory/specs/production-handoff-packet-v1.schema.json",
+  "title": "Enigma Production Handoff Packet v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "generated_at",
+    "project",
+    "go_live_ready",
+    "local_static_artifact_ready",
+    "credentials_present",
+    "pages",
+    "infrastructure",
+    "operator_acceptance",
+    "next_actions",
+    "blockers",
+    "claim_boundary"
+  ],
+  "properties": {
+    "schema": { "const": "enigma.production_handoff_packet.v1" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "project": { "$ref": "#/$defs/project" },
+    "go_live_ready": { "type": "boolean" },
+    "local_static_artifact_ready": { "type": "boolean" },
+    "credentials_present": { "$ref": "#/$defs/credentials" },
+    "pages": { "$ref": "#/$defs/pages" },
+    "infrastructure": { "$ref": "#/$defs/infrastructure" },
+    "operator_acceptance": { "$ref": "#/$defs/operatorAcceptance" },
+    "next_actions": { "type": "array", "items": { "$ref": "#/$defs/action" } },
+    "blockers": { "type": "array", "items": { "type": "string" } },
+    "claim_boundary": { "type": "array", "items": { "type": "string" } }
+  },
+  "$defs": {
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "domain", "cloudflare_pages_project", "site"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "domain": { "type": ["string", "null"] },
+        "cloudflare_pages_project": { "type": "string", "minLength": 1 },
+        "site": { "type": "string", "minLength": 1 }
+      }
+    },
+    "credentials": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cloudflare_api_token", "cloudflare_account_id"],
+      "properties": {
+        "cloudflare_api_token": { "type": "boolean" },
+        "cloudflare_account_id": { "type": "boolean" }
+      }
+    },
+    "pages": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "local_artifact_ready",
+        "automated_deploy_ready",
+        "credential_present",
+        "artifact_file_count",
+        "artifact_root_hash",
+        "security_blocker_count",
+        "deployment_blockers",
+        "live_observation"
+      ],
+      "properties": {
+        "schema": { "const": "enigma.cloudflare_pages_release_packet.v1" },
+        "local_artifact_ready": { "type": "boolean" },
+        "automated_deploy_ready": { "type": "boolean" },
+        "credential_present": { "type": "boolean" },
+        "artifact_file_count": { "type": ["integer", "null"], "minimum": 0 },
+        "artifact_root_hash": { "type": ["string", "null"], "pattern": "^sha256:[a-fA-F0-9]{64}$" },
+        "security_blocker_count": { "type": ["integer", "null"], "minimum": 0 },
+        "deployment_blockers": { "type": "array", "items": { "type": "string" } },
+        "live_observation": { "$ref": "#/$defs/nullableLiveObservation" }
+      }
+    },
+    "nullableLiveObservation": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["ok", "live_url", "status", "title", "title_matched", "blockers"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "live_url": { "type": ["string", "null"] },
+        "status": { "type": ["integer", "null"] },
+        "title": { "type": ["string", "null"] },
+        "title_matched": { "type": "boolean" },
+        "blockers": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "infrastructure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "ok",
+        "mode",
+        "contract_ready",
+        "hosted_live_ready",
+        "public_live_ready",
+        "cloudflare_observed",
+        "hosted_required_ref_count",
+        "hosted_required_ref_missing_count",
+        "external_blocker_count",
+        "external_blockers"
+      ],
+      "properties": {
+        "schema": { "const": "enigma.infrastructure_readiness.v1" },
+        "ok": { "type": "boolean" },
+        "mode": { "type": "string" },
+        "contract_ready": { "type": "boolean" },
+        "hosted_live_ready": { "type": "boolean" },
+        "public_live_ready": { "type": "boolean" },
+        "cloudflare_observed": { "type": "boolean" },
+        "hosted_required_ref_count": { "type": ["integer", "null"], "minimum": 0 },
+        "hosted_required_ref_missing_count": { "type": ["integer", "null"], "minimum": 0 },
+        "external_blocker_count": { "type": ["integer", "null"], "minimum": 0 },
+        "external_blockers": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "operatorAcceptance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema", "ok", "decision", "blocker_count", "warning_count"],
+      "properties": {
+        "schema": { "const": "enigma.operator_acceptance_result.v1" },
+        "ok": { "type": "boolean" },
+        "decision": { "type": "string" },
+        "blocker_count": { "type": "integer", "minimum": 0 },
+        "warning_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "action": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "owner", "command", "evidence"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "owner": { "type": "string", "minLength": 1 },
+        "command": { "type": "string", "minLength": 1 },
+        "evidence": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/specs/receipt-v1.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/receipt-v1.schema.json",
+  "title": "Enigma Receipt v1",
+  "type": "object",
+  "required": [
+    "schema",
+    "receipt_id",
+    "event_hash",
+    "operation",
+    "tenant_id",
+    "subject_id",
+    "sequence",
+    "previous_receipt_hash",
+    "active_set_root",
+    "receipt_log_root",
+    "timestamp",
+    "signer",
+    "signature"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.receipt.v1" },
+    "receipt_id": { "type": "string", "minLength": 8 },
+    "event_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "operation": {
+      "type": "string",
+      "enum": ["create", "read", "update", "supersede", "delete", "retrieve", "inject", "export", "import", "deny", "quarantine", "boundary_cross"]
+    },
+    "tenant_id": { "type": "string", "minLength": 1 },
+    "subject_id": { "type": "string", "minLength": 1 },
+    "memory_addr": { "type": "string" },
+    "source_addr": { "type": "string" },
+    "provider": { "type": "string" },
+    "model": { "type": "string" },
+    "policy_id": { "type": "string" },
+    "sequence": { "type": "integer", "minimum": 0 },
+    "previous_receipt_hash": { "type": "string", "pattern": "^(sha256:[a-f0-9]{64}|GENESIS)$" },
+    "active_set_root": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "receipt_log_root": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "signer": {
+      "type": "object",
+      "required": ["key_id", "alg"],
+      "additionalProperties": false,
+      "properties": {
+        "key_id": { "type": "string", "minLength": 1 },
+        "alg": { "const": "Ed25519" }
+      }
+    },
+    "signature": {
+      "type": "object",
+      "required": ["alg", "value"],
+      "additionalProperties": false,
+      "properties": {
+        "alg": { "const": "Ed25519" },
+        "value": { "type": "string", "minLength": 64 }
+      }
+    }
+  }
+}

package/specs/relay-record-v1.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/relay-record-v1.schema.json",
+  "title": "Enigma Relay Record v1",
+  "type": "object",
+  "required": [
+    "schema",
+    "record_id",
+    "store_id",
+    "capsule_id",
+    "encrypted_payload_hash",
+    "opaque_encrypted_record",
+    "received_at",
+    "expires_at",
+    "signature"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.relay_record.v1" },
+    "record_id": { "type": "string", "minLength": 8 },
+    "relay_record_id": { "type": "string", "minLength": 8 },
+    "store_id": { "type": "string", "minLength": 1 },
+    "capsule_id": { "type": ["string", "null"] },
+    "encrypted_payload_hash": { "$ref": "#/$defs/sha256Root" },
+    "opaque_encrypted_record": { "type": "string", "minLength": 1 },
+    "received_at": { "type": "string", "format": "date-time" },
+    "expires_at": { "type": ["string", "null"], "format": "date-time" },
+    "signature": { "$ref": "#/$defs/signature" }
+  },
+  "$defs": {
+    "sha256Root": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "signature": {
+      "type": "object",
+      "required": ["alg", "key_id", "value"],
+      "additionalProperties": false,
+      "properties": {
+        "alg": { "const": "Ed25519" },
+        "key_id": { "type": "string", "minLength": 1 },
+        "value": { "type": "string", "minLength": 64 }
+      }
+    }
+  }
+}

package/specs/state-checkpoint-v1.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/state-checkpoint-v1.schema.json",
+  "title": "Enigma State Checkpoint v1",
+  "type": "object",
+  "required": ["schema", "checkpoint_id", "tenant_hash", "owner_scope_hash", "epoch", "active_memory_root", "deleted_memory_root", "receipt_log_root", "key_registry_root", "policy_registry_root", "previous_checkpoint_hash", "issued_at", "signatures"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.state_checkpoint.v1" },
+    "checkpoint_id": { "type": "string", "minLength": 8 },
+    "tenant_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "owner_scope_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "epoch": { "type": "integer", "minimum": 0 },
+    "active_memory_root": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "deleted_memory_root": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "receipt_log_root": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "key_registry_root": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "policy_registry_root": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "previous_checkpoint_hash": { "type": "string", "pattern": "^(sha256:[a-f0-9]{64}|GENESIS)$" },
+    "witness_policy": { "type": "string" },
+    "issued_at": { "type": "string", "format": "date-time" },
+    "signatures": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["alg", "key_id", "value"],
+        "additionalProperties": false,
+        "properties": {
+          "alg": { "type": "string", "enum": ["Ed25519", "Ed25519+ML-DSA-policy"] },
+          "key_id": { "type": "string", "minLength": 1 },
+          "value": { "type": "string", "minLength": 64 }
+        }
+      }
+    }
+  }
+}

package/specs/trust-bundle-v1.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/trust-bundle-v1.schema.json",
+  "title": "Enigma Trust Bundle v1",
+  "type": "object",
+  "required": ["schema", "bundle_id", "created_at", "trusted_issuers", "trusted_witnesses", "accepted_algorithms", "revocations"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.trust_bundle.v1" },
+    "bundle_id": { "type": "string", "minLength": 8 },
+    "created_at": { "type": "string", "format": "date-time" },
+    "trusted_issuers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["issuer_id", "key_id", "public_key", "scope"],
+        "additionalProperties": false,
+        "properties": {
+          "issuer_id": { "type": "string", "minLength": 1 },
+          "key_id": { "type": "string", "minLength": 1 },
+          "public_key": { "type": "string", "minLength": 1 },
+          "scope": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "trusted_witnesses": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["witness_id", "key_id", "public_key"],
+        "additionalProperties": false,
+        "properties": {
+          "witness_id": { "type": "string", "minLength": 1 },
+          "key_id": { "type": "string", "minLength": 1 },
+          "public_key": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "accepted_algorithms": { "type": "array", "items": { "type": "string", "enum": ["Ed25519", "Ed25519+ML-DSA-policy", "sha256", "hmac-sha256"] } },
+    "import_capsule_policy": {
+      "type": "object",
+      "required": ["private_plaintext_boundary", "completeness_evidence_required", "recognized_importer_count", "unsupported_importer_count"],
+      "additionalProperties": false,
+      "properties": {
+        "private_plaintext_boundary": {
+          "type": "string",
+          "enum": ["payload_private_public_artifacts_hash_only"]
+        },
+        "completeness_evidence_required": { "type": "boolean" },
+        "recognized_importer_count": { "type": "integer", "minimum": 0 },
+        "unsupported_importer_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "revocations": { "type": "array", "items": { "type": "string" } }
+  }
+}