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
caller_ip		Source IP for security / anomaly analysis.	compute_executions
created_at	TIMESTAMPTZ	Row creation timestamp (UTC).	compute_method_registry
created_at		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	v_framework_criteria_latest
dataset_hashes		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
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	v_framework_criteria_latest
engine	enum	Rule evaluation engine (jsonlogic, cel)	standards_criteria
engine	enum	Rule engine used	v_framework_criteria_latest
error_code		Machine-readable error code if status='error' (e.g., SCHEMA_VALIDATION_FAILED).	compute_executions
exec_id		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	v_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		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
iso_cc_id	string	Internal surrogate key for ISO country record	dim_countries
iso_cd_id	string	Internal surrogate key for ISO country record	dim_countries
latency_ms		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		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
options_hash		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		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
provenance_id		Correlation ID returned to caller; links UI/API to this audit row.	compute_executions
region		Region tag where compute ran (e.g., eu-north-1).	compute_executions
rule_json	jsonb	Serialized rule definition executed by the policy engine	standards_criteria
rule_json	jsonb	Latest executable rule definition	v_framework_criteria_latest
severity	enum	Enforcement level (block, warn, info)	standards_criteria
severity	enum	Enforcement severity	v_framework_criteria_latest
status	TEXT	Lifecycle state: supported | beta | deprecated. Used by discovery and allowlists.	compute_method_registry
status		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		Pointer to sealed blob with full input/output snapshots if retained.	compute_executions
tenant_id		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
test_id	string	Test	test
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	v_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		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	v_framework_criteria_latest