Signals Registry

Global catalog of signals used across ZAYAZ engines, micro-engines, and modules.

This registry lists:

Universally addressable signal names
Their data types
Descriptions
Origin source tables

Example:

  {
    "signal_name": "iso_cc_id",
    "signal_type": "string",
    "signal_description": "Internal surrogate key for ISO country record",
    "source_table": "dim_countries",
    "source_file": "countries.xlsx",
    "family": "id",
    "status": "stable",
    "used_by_engines": ["zhif", "pef-me"],
    "used_by_modules": ["sem"],
    "example": ["iso-028"]
  }

Signal Name	Type	Description	Source Table
`acl_tags`	JSONB	Array of policy tags for enforcement (e.g., ['EU_ONLY','NO_PHI']). Validated against ACL Tag Registry (acl_tag_registry).	`compute_method_registry`
`alb_dns`	string / aws_alb_dns	AWS-generated DNS name of the regional Application Load Balancer serving this API region. Used as the Cloudflare CNAME target. May be empty until ingress is provisioned.	`residency_region_policy`
`api`	string / dns_hostname	Regional API hostname used for tenant routing (e.g. api.eu-north-1.zayaz.io). This is the externally visible ingress endpoint.	`residency_region_policy`
`aws_region`	string / aws_region	Human-readable AWS region name and code describing the physical deployment location (e.g. Europe (Stockholm) eu-north-1).	`residency_region_policy`
`caller_ip`	TEXT	Source IP for security / anomaly analysis.	`compute_executions`
`created_at`	TIMESTAMPTZ	Row creation timestamp (UTC).	`compute_method_registry`
`created_at`	TEXT	Execution timestamp (UTC).	`compute_executions`
`created_at`	timestamptz	Timestamp when the framework record was created	`standards_frameworks`
`created_at`	timestamptz	Timestamp when the criterion was created	`standards_criteria`
`created_at`	timestamptz	Timestamp when the tenant-framework link was created	`tenant_frameworks`
`criterion_id`	string (pk)	Canonical identifier of a policy criterion (e.g. ESRS.data_residency.eu_only)	`standards_criteria`
`criterion_id`	string	Criterion identifier	`framework_criteria_latest`
`dataset_hashes`	TEXT	Array/map of dataset artifact hashes used (e.g., ['IPCC-EFDB:sha256-...','IEA_SSP:sha256-...']).	`compute_executions`
`dataset_requirements`	JSONB	Array/object describing required datasets/refs, e.g. ['IPCC-EFDB','IEA_SSP']. Validated against dataset_key registry.	`compute_method_registry`
`default_countries`	json / iso_country_list	List of ISO-3166-1 alpha-2 country codes that default to this AWS region during tenant onboarding. Used for suggestion only, not enforcement.	`residency_region_policy`
`description`	TEXT	Human-readable summary of what the method computes and when to use it.	`compute_method_registry`
`description`	string	Textual description of scope and purpose of the framework	`standards_frameworks`
`description`	string	Human-readable explanation of the criterion	`standards_criteria`
`description`	string	Criterion description	`framework_criteria_latest`
`dr_encryption`	string / encryption_policy	Required encryption standard for all DR copies (e.g. sse_kms_required). Applies to both SR and RR modes.	`residency_region_policy`
`dr_region_rr`	string / aws_region \| null	Disaster recovery region used under Resilient Residency (RR) mode. May be cross-zone if explicitly allowed. null when RR is not supported for this primary region.	`residency_region_policy`
`dr_region_sr`	string / aws_region	Disaster recovery region used under Strict Residency (SR) mode. Must remain inside the same residency zone. May equal the primary region in single-region zones.	`residency_region_policy`
`effective_from`	timestamptz	Valid from date	`residency_region_policy`
`effective_to`	timestamptz	Date of deprecation	`residency_region_policy`
`engine`	enum	Rule evaluation engine (jsonlogic, cel)	`standards_criteria`
`engine`	enum	Rule engine used	`framework_criteria_latest`
`error_code`	TEXT	Machine-readable error code if status='error' (e.g., SCHEMA_VALIDATION_FAILED).	`compute_executions`
`exec_id`	string (pk)	Globally unique execution ID (ULID). Primary key.	`compute_executions`
`framework_id`	string (pk)	Canonical identifier of a standards framework (e.g. ESRS, ISSB, SEC). Globally stable and later usable as a USO concept anchor, a policy routing key in TR/PG, a compliance scope discriminator in ZADIF	`standards_frameworks`
`framework_id`	string (fk)	Reference to owning standards framework	`standards_criteria`
`framework_id`	string (pk, fk)	Framework enabled or disabled for the tenant	`tenant_frameworks`
`framework_id`	string	Framework identifier	`framework_criteria_latest`
`implementation_ref`	TEXT	Resolvable entrypoint, e.g. python://zayaz.compute.ghg:intensity_v1 or container/image ref. Loader imports/calls this.	`compute_method_registry`
`inputs_hash`	TEXT	Cryptographic hash (e.g., sha256:...) of normalized input payload.	`compute_executions`
`inputs_schema_json`	TEXT	ZAR artifact ID for JSON Schema describing required/optional input fields and constraints (units, mins, enums). Enforced at runtime.	`compute_method_registry`
`latency_ms`	TEXT	End-to-end compute latency in milliseconds.	`compute_executions`
`method_id`	TEXT (PK)	Surrogate ID for the compute method, e.g. MID-00001. Used as stable contract ID across ZAYAZ.	`compute_method_registry`
`method_id`	TEXT	Method name (e.g., GHG.intensity, Water.abs). Primary key; one 'latest' row per method.	`compute_method_latest`
`method_id`	TEXT	Method ID (e.g., MID-00001). FK part 1 → ref_compute_method_registry.method_id.	`compute_executions`
`method_name`	TEXT	Canonical method name, e.g. GHG.intensity, Water.abs. Human/machine-friendly semantic identifier.	`compute_method_registry`
`name`	string	Human-readable name of the standards framework	`standards_frameworks`
`note`	TEXT	Admin/operator note explaining why this version is latest (e.g., 'post–gate promotion', 'hotfix').	`compute_method_latest`
`notes`	string	Tenant-specific annotations or governance notes	`tenant_frameworks`
`notes`	string / governance_notes	Rationale and governance notes explaining regional constraints, DR strategy, and compliance considerations. Intended for auditors, architects, and operators.	`residency_region_policy`
`options_hash`	TEXT	Cryptographic hash of normalized options payload.	`compute_executions`
`options_schema_json`	TEXT	ZAR artifact ID for JSON Schema describing optional method options (e.g., jurisdiction, scope3_category). May point to a trivial {} schema.	`compute_method_registry`
`output_hash`	TEXT	Cryptographic hash of normalized output payload. Optional if execution failed pre-output.	`compute_executions`
`output_schema_json`	TEXT	ZAR artifact ID for JSON Schema describing method output payload (e.g., result, unit, provenance). Enforced post-compute.	`compute_method_registry`
`primary_region`	string / aws_region	AWS region used as the tenant’s primary data and compute location under normal operation.	`residency_region_policy`
`provenance_id`	TEXT	Correlation ID returned to caller; links UI/API to this audit row.	`compute_executions`
`region`	TEXT	Region tag where compute ran (e.g., eu-north-1).	`compute_executions`
`region_note`	string / descriptive_label	Human-readable short description of the region for internal clarity (e.g. AF Cape Town, AP Tokyo).	`residency_region_policy`
`rr_allowed`	boolean / policy_flag	Indicates whether Resilient Residency (cross-zone emergency DR) is permitted for this primary region.	`residency_region_policy`
`rrp_id`	string / identifier	Unique identifier for the residency region policy record. Used for traceability, versioning, and audit references.	`residency_region_policy`
`rule_json`	jsonb	Serialized rule definition executed by the policy engine	`standards_criteria`
`rule_json`	jsonb	Latest executable rule definition	`framework_criteria_latest`
`s3_link`	string / aws_s3_bucket_ref	Canonical S3 bucket identifier used for tenant production data in this primary AWS region (e.g. zyz-td-eu-north-1).	`residency_region_policy`
`secondary_region`	string / aws_region	AWS region used for high availability or fast recovery. Must always remain within the same residency zone as the primary region.	`residency_region_policy`
`severity`	enum	Enforcement level (block, warn, info)	`standards_criteria`
`severity`	enum	Enforcement severity	`framework_criteria_latest`
`status`	TEXT	Lifecycle state: supported \| beta \| deprecated. Used by discovery and allowlists.	`compute_method_registry`
`status`	TEXT	ok \| error. Final outcome.	`compute_executions`
`status`	enum	Lifecycle status of the framework (supported, beta, deprecated)	`standards_frameworks`
`status`	enum	Enablement state (enabled, disabled)	`tenant_frameworks`
`storage_ref`	TEXT	Pointer to sealed blob with full input/output snapshots if retained.	`compute_executions`
`tenant_id`	TEXT	Tenant/customer identifier (used for multi-tenant isolation and audit).	`compute_executions`
`tenant_id`	string (pk, fk)	Tenant identifier (E-C-O™ Number or internal tenant key)	`tenant_frameworks`
`updated_at`	TIMESTAMPTZ	Row last update timestamp (UTC)	`compute_method_registry`
`updated_at`	TIMESTAMPTZ	Timestamp (UTC) when 'latest' pointer was last changed.	`compute_method_latest`
`updated_at`	timestamptz	Timestamp when the framework record was last updated	`standards_frameworks`
`updated_at`	timestamptz	Timestamp when the criterion was last updated	`standards_criteria`
`updated_at`	timestamptz	Timestamp when the tenant-framework link was last updated	`tenant_frameworks`
`updated_at`	timestamptz	Timestamp of the latest criterion update	`framework_criteria_latest`
`version`	TEXT	Semantic version of the method implementation and schema (e.g., 1.0.0). Enables side-by-side versions.	`compute_method_registry`
`version`	TEXT	Version currently designated as 'latest' for this method (e.g., 1.1.0). FK to compute_method_registry(method_id, version).	`compute_method_latest`
`version`	TEXT	Exact version used (e.g., 1.0.0). FK part 2 → ref_compute_method_registry.version.	`compute_executions`
`version`	string	Semantic version of the criterion rule	`standards_criteria`
`version`	string	Latest version of the criterion	`framework_criteria_latest`
`vpc_cid`	string / cidr_block	CIDR block allocated to the regional ingress VPC. Must be globally non-overlapping across all ZYZ regions.	`residency_region_policy`
`zone`	string / residency_zone	Logical data residency zone representing the legal/policy boundary (e.g. eu, na, as, af, me, sa).	`residency_region_policy`

GitHub Repo Request for Change (RFC)

Example:​

Example: