enigma-memory 0.1.0

package/specs/capsule-v1.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/capsule-v1.schema.json",
+  "title": "Enigma Capsule v1",
+  "type": "object",
+  "required": ["schema", "capsule_id", "capsule_type", "issuer", "created_at", "expires_at", "scope", "payload", "proofs"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.capsule.v1" },
+    "capsule_id": { "type": "string", "minLength": 8 },
+    "capsule_type": { "type": "string", "enum": ["personal_passport", "project", "session", "audit", "migration"] },
+    "issuer": { "type": "string", "minLength": 1 },
+    "holder": { "type": "string" },
+    "created_at": { "type": "string", "format": "date-time" },
+    "expires_at": { "type": "string", "format": "date-time" },
+    "scope": {
+      "type": "object",
+      "required": ["subjects", "operations"],
+      "additionalProperties": false,
+      "properties": {
+        "subjects": { "type": "array", "items": { "type": "string" } },
+        "memory_addrs": { "type": "array", "items": { "type": "string" } },
+        "operations": { "type": "array", "items": { "type": "string" } },
+        "purpose": { "type": "string" }
+      }
+    },
+    "payload": {
+      "type": "object",
+      "required": ["encryption", "objects_ref"],
+      "additionalProperties": false,
+      "properties": {
+        "encryption": { "type": "string", "enum": ["encrypted", "receipt_only", "plaintext_user_requested"] },
+        "objects_ref": { "type": "string" }
+      }
+    },
+    "proofs": {
+      "type": "object",
+      "required": ["receipt_log_root", "active_set_root"],
+      "additionalProperties": false,
+      "properties": {
+        "receipt_log_root": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$",
+          "description": "Canonical custody roots must be derived from receipt objects that are available for verification; receipt-hash-only claims are candidate evidence."
+        },
+        "active_set_root": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$",
+          "description": "Canonical custody roots must commit only memory addresses backed by matching receipt objects, not arbitrary receipt hashes."
+        },
+        "receipt_bundle_ref": { "type": "string" }
+      }
+    }
+  }
+}

package/specs/claim-boundary-manifest-v1.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/claim-boundary-manifest-v1.schema.json",
+  "title": "Enigma Claim Boundary Manifest v1",
+  "type": "object",
+  "required": ["schema", "claim_id", "claim_text", "allowed_scope", "forbidden_interpretations", "required_artifact_types", "truth_boundary", "not_proven", "release_status", "owner", "review_epoch"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.claim_boundary_manifest.v1" },
+    "claim_id": { "type": "string", "minLength": 8 },
+    "claim_text": { "type": "string", "minLength": 1 },
+    "allowed_scope": { "type": "string", "minLength": 1 },
+    "forbidden_interpretations": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "required_artifact_types": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "required_tests": { "type": "array", "items": { "type": "string" } },
+    "truth_boundary": { "type": "string", "minLength": 1 },
+    "not_proven": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "release_status": { "type": "string", "enum": ["draft", "internal", "public", "withdrawn"] },
+    "owner": { "type": "string", "minLength": 1 },
+    "review_epoch": { "type": "integer", "minimum": 0 }
+  }
+}

package/specs/connector-profile-v1.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/connector-profile-v1.schema.json",
+  "title": "Enigma Connector Profile v1",
+  "type": "object",
+  "required": [
+    "schema",
+    "client_id",
+    "display_name",
+    "platforms",
+    "default_config_path",
+    "default_config_paths",
+    "config_format",
+    "server_container_path",
+    "server_name",
+    "command",
+    "required_env"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.connector_profile.v1" },
+    "client_id": {
+      "type": "string",
+      "enum": ["claude-desktop", "cursor", "kimi-code", "vscode-cline", "roo", "opencode", "generic-mcp"]
+    },
+    "display_name": { "type": "string", "minLength": 1 },
+    "description": { "type": "string", "minLength": 1 },
+    "platforms": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 3,
+      "items": { "type": "string", "enum": ["win32", "darwin", "linux"] },
+      "uniqueItems": true
+    },
+    "default_config_path": { "type": "string", "minLength": 1 },
+    "default_config_paths": {
+      "type": "object",
+      "required": ["win32", "darwin", "linux"],
+      "additionalProperties": false,
+      "properties": {
+        "win32": { "type": "string", "minLength": 1 },
+        "darwin": { "type": "string", "minLength": 1 },
+        "linux": { "type": "string", "minLength": 1 }
+      }
+    },
+    "config_format": { "const": "json" },
+    "server_container_path": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "server_name": { "type": "string", "minLength": 1 },
+    "command": { "const": "enigma-mcp" },
+    "required_env": {
+      "type": "array",
+      "contains": { "const": "ENIGMA_BUNDLE" },
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "platform": { "type": "string", "enum": ["win32", "darwin", "linux"] }
+  }
+}

package/specs/deletion-tombstone-v1.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/deletion-tombstone-v1.schema.json",
+  "title": "Enigma Deletion Tombstone v1",
+  "type": "object",
+  "required": ["schema", "tombstone_id", "delete_receipt_hash", "target_memory_addrs", "effective_epoch", "active_memory_root_after", "deleted_memory_root_after", "erasure_scope", "not_proven", "issued_at"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.deletion_tombstone.v1" },
+    "tombstone_id": { "type": "string", "minLength": 8 },
+    "delete_receipt_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "target_memory_addrs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "effective_epoch": { "type": "integer", "minimum": 0 },
+    "active_memory_root_after": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "deleted_memory_root_after": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "erasure_scope": {
+      "type": "array",
+      "items": { "type": "string", "enum": ["active_store", "local_cache", "device_sync_peer", "encrypted_backup", "enterprise_tenant_store", "user_export_bundle"] }
+    },
+    "key_refs_destroyed": { "type": "array", "items": { "type": "string" } },
+    "downstream_delete_request_hashes": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } },
+    "backup_treatment": { "type": "string", "enum": ["not_applicable", "purged", "tombstoned_unreadable_by_destroyed_key", "legal_hold_retained", "outside_scope"] },
+    "not_proven": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "issued_at": { "type": "string", "format": "date-time" }
+  }
+}

package/specs/enterprise-policy-v1.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/enterprise-policy-v1.schema.json",
+  "title": "Enigma Enterprise Policy v1",
+  "type": "object",
+  "required": ["schema", "policy_id", "tenant_id", "mode", "created_at", "updated_at", "default_action", "allowed_providers", "allowed_models", "allowed_regions", "denied_sensitivities", "allowed_purposes", "legal_holds", "retention_days", "kms", "provider_native_memory", "policy_hash"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.enterprise_policy.v1" },
+    "policy_id": { "type": "string", "minLength": 1 },
+    "tenant_id": { "type": "string", "minLength": 1 },
+    "mode": { "type": "string", "enum": ["hosted", "byoc", "on_prem"] },
+    "created_at": { "type": "string", "format": "date-time" },
+    "updated_at": { "type": "string", "format": "date-time" },
+    "default_action": { "const": "deny_unknown" },
+    "allowed_providers": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+    "allowed_models": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+    "allowed_regions": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+    "denied_sensitivities": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+    "allowed_purposes": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+    "legal_holds": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["hold_id", "status"],
+        "additionalProperties": false,
+        "properties": {
+          "hold_id": { "type": "string", "minLength": 1 },
+          "memory_addr": { "type": "string", "minLength": 1 },
+          "memory_id": { "type": "string", "minLength": 1 },
+          "subject_id": { "type": "string", "minLength": 1 },
+          "scope_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+          "reason_code": { "type": "string", "minLength": 1 },
+          "status": { "type": "string", "enum": ["active", "released"] }
+        },
+        "anyOf": [
+          { "required": ["memory_addr"] },
+          { "required": ["memory_id"] },
+          { "required": ["subject_id"] },
+          { "required": ["scope_hash"] }
+        ]
+      }
+    },
+    "retention_days": { "type": "integer", "minimum": 0 },
+    "kms": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "provider": { "type": "string", "minLength": 1 },
+        "key_id": { "type": "string", "minLength": 1 },
+        "key_version": { "type": "string", "minLength": 1 },
+        "region": { "type": "string", "minLength": 1 },
+        "evidence_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "provider_native_memory": { "const": "cache_only" },
+    "policy_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/specs/gateway-request-v1.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.enigma.ai/gateway-request-v1.schema.json",
+  "title": "Enigma Gateway Request v1",
+  "type": "object",
+  "required": ["schema", "operation", "provider", "model", "region", "purpose", "sensitivity"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "enigma.gateway_request.v1" },
+    "operation": { "type": "string", "enum": ["retrieve", "write", "delete", "compile_context", "search"] },
+    "provider": { "type": "string", "minLength": 1 },
+    "model": { "type": "string", "minLength": 1 },
+    "region": { "type": "string", "minLength": 1 },
+    "purpose": { "type": "string", "minLength": 1 },
+    "sensitivity": { "type": "string", "minLength": 1 },
+    "memory_addr": { "type": "string", "minLength": 1 },
+    "memory_id": { "type": "string", "minLength": 1 },
+    "subject_id": { "type": "string", "minLength": 1 },
+    "legal_hold_delete": { "type": "boolean" }
+  },
+  "not": {
+    "anyOf": [
+      { "required": ["memory"] },
+      { "required": ["memory_text"] },
+      { "required": ["memory_plaintext"] },
+      { "required": ["plaintext"] },
+      { "required": ["raw_memory"] },
+      { "required": ["content"] },
+      { "required": ["value"] }
+    ]
+  }
+}

package/specs/goal-completion-audit-v1.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://enigma.memory/specs/goal-completion-audit-v1.schema.json",
+  "title": "Enigma Goal Completion Audit v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "generated_at",
+    "objective",
+    "complete",
+    "release_posture",
+    "go_live_ready",
+    "local_static_artifact_ready",
+    "deliverables",
+    "backend_readiness_smoke",
+    "blockers",
+    "next_actions",
+    "claim_boundary"
+  ],
+  "properties": {
+    "schema": { "const": "enigma.goal_completion_audit.v1" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "objective": { "type": "string", "minLength": 1 },
+    "complete": { "type": "boolean" },
+    "release_posture": { "type": "string", "minLength": 1 },
+    "go_live_ready": { "type": "boolean" },
+    "local_static_artifact_ready": { "type": "boolean" },
+    "deliverables": { "type": "array", "items": { "$ref": "#/$defs/deliverable" } },
+    "backend_readiness_smoke": { "$ref": "#/$defs/backendReadinessSmoke" },
+    "blockers": { "type": "array", "items": { "type": "string" } },
+    "next_actions": { "type": "array", "items": { "$ref": "#/$defs/action" } },
+    "claim_boundary": { "type": "array", "items": { "type": "string" } }
+  },
+  "$defs": {
+    "deliverable": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "requirement", "ok", "evidence", "blockers"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "requirement": { "type": "string", "minLength": 1 },
+        "ok": { "type": "boolean" },
+        "evidence": { "type": "array", "items": { "type": "string" } },
+        "blockers": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "backendReadinessSmoke": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "check_count", "loopback_only"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "check_count": { "type": "integer", "minimum": 0 },
+        "loopback_only": { "type": "boolean" }
+      }
+    },
+    "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/hosted-backend-live-evidence-v1.schema.json

@@ -0,0 +1,147 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://enigma.memory/specs/hosted-backend-live-evidence-v1.schema.json",
+  "title": "Enigma Hosted Backend Live Evidence v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "observed_at",
+    "environment",
+    "refs",
+    "probes",
+    "operator_acceptance",
+    "claim_boundary"
+  ],
+  "properties": {
+    "schema": { "const": "enigma.hosted_backend_live_evidence.v1" },
+    "observed_at": { "type": "string", "format": "date-time" },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["environment_id", "domain", "cloud_provider", "region", "owner", "status"],
+      "properties": {
+        "environment_id": { "type": "string", "minLength": 1 },
+        "domain": { "type": "string", "minLength": 1 },
+        "cloud_provider": { "type": "string", "minLength": 1 },
+        "region": { "type": "string", "minLength": 1 },
+        "owner": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["observed", "verified", "go", "accepted"] }
+      }
+    },
+    "refs": {
+      "type": "object",
+      "required": [
+        "backend_host",
+        "dns_tls",
+        "durable_storage",
+        "kms_or_secret_custody",
+        "backup_restore",
+        "monitoring",
+        "siem_or_log_sink",
+        "operator_acceptance",
+        "runtime_auth",
+        "admin_auth",
+        "data_plane_auth",
+        "network_access_policy",
+        "kms_custody",
+        "tenant_policy_approval",
+        "usage_metering",
+        "service_settlement",
+        "monitoring_alerting",
+        "public_site_security",
+        "security_threat_model",
+        "legal_compliance_approval",
+        "support_sla",
+        "incident_drill",
+        "backup_restore_drill",
+        "relay_deployment",
+        "gateway_deployment"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "backend_host": { "type": "string", "minLength": 1 },
+        "dns_tls": { "type": "string", "minLength": 1 },
+        "durable_storage": { "type": "string", "minLength": 1 },
+        "kms_or_secret_custody": { "type": "string", "minLength": 1 },
+        "backup_restore": { "type": "string", "minLength": 1 },
+        "monitoring": { "type": "string", "minLength": 1 },
+        "siem_or_log_sink": { "type": "string", "minLength": 1 },
+        "operator_acceptance": { "type": "string", "minLength": 1 },
+        "runtime_auth": { "type": "string", "minLength": 1 },
+        "admin_auth": { "type": "string", "minLength": 1 },
+        "data_plane_auth": { "type": "string", "minLength": 1 },
+        "network_access_policy": { "type": "string", "minLength": 1 },
+        "kms_custody": { "type": "string", "minLength": 1 },
+        "tenant_policy_approval": { "type": "string", "minLength": 1 },
+        "usage_metering": { "type": "string", "minLength": 1 },
+        "service_settlement": { "type": "string", "minLength": 1 },
+        "monitoring_alerting": { "type": "string", "minLength": 1 },
+        "public_site_security": { "type": "string", "minLength": 1 },
+        "security_threat_model": { "type": "string", "minLength": 1 },
+        "legal_compliance_approval": { "type": "string", "minLength": 1 },
+        "support_sla": { "type": "string", "minLength": 1 },
+        "incident_drill": { "type": "string", "minLength": 1 },
+        "backup_restore_drill": { "type": "string", "minLength": 1 },
+        "relay_deployment": { "type": "string", "minLength": 1 },
+        "gateway_deployment": { "type": "string", "minLength": 1 }
+      }
+    },
+    "probes": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["relay_livez", "relay_readyz", "gateway_livez", "gateway_readyz"],
+      "properties": {
+        "relay_livez": { "$ref": "#/$defs/probe" },
+        "relay_readyz": { "$ref": "#/$defs/probe" },
+        "gateway_livez": { "$ref": "#/$defs/probe" },
+        "gateway_readyz": { "$ref": "#/$defs/probe" }
+      }
+    },
+    "operator_acceptance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["decision", "packet_ref", "approved_at", "approved_by"],
+      "properties": {
+        "decision": { "const": "go" },
+        "packet_ref": { "type": "string", "minLength": 1 },
+        "approved_at": { "type": "string", "format": "date-time" },
+        "approved_by": { "type": "string", "minLength": 1 }
+      }
+    },
+    "claim_boundary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "hosted_backend_live",
+        "public_site_live",
+        "cloudflare_credentials_claim",
+        "token_roi_claim",
+        "provider_deletion_claim",
+        "model_forgetting_claim"
+      ],
+      "properties": {
+        "hosted_backend_live": { "const": true },
+        "public_site_live": { "const": false },
+        "cloudflare_credentials_claim": { "const": false },
+        "token_roi_claim": { "const": false },
+        "provider_deletion_claim": { "const": false },
+        "model_forgetting_claim": { "const": false }
+      }
+    }
+  },
+  "$defs": {
+    "probe": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["url", "status_code", "body", "observed_at", "response_hash"],
+      "properties": {
+        "url": { "type": "string", "format": "uri" },
+        "status_code": { "const": 200 },
+        "body": { "type": "object" },
+        "observed_at": { "type": "string", "format": "date-time" },
+        "response_hash": { "type": "string", "pattern": "^sha256:[a-fA-F0-9]{64}$" }
+      }
+    }
+  }
+}