Skip to main content
Jira progress: loading…

pef-me

Style Examples Used in the Docs

Advanced Topic – IPCC GLOSSARY (PDF)

Integrity Check Report (v1)

Ruleset Snippet​

import RulesetSnippet from "@site/src/components/RulesetSnippet";
DEV:
<RulesetSnippet
  file=file="dev/MEID_ACCT_CRAWLER/acct-crawler-tag-detection-1_0_0.yaml"
  title="Acct Crawler Tag Detection (v1.0.0)"
  showLineNumbers
/>

or 
STAGING:
<RulesetSnippet
  file=file="staging/EID_MAIN_ENGINE/foo-1_0_0.yaml"
  title="Acct Crawler Tag Detection (v1.0.0)"
  showLineNumbers
/>

or 
PROD:
<RulesetSnippet
  file=file="prod/MEID_ACCT_CRAWLER/acct-crawler-tag-detection-1_0_0.yaml"
  title="Acct Crawler Tag Detection (v1.0.0)"
  showLineNumbers
/>

Code snippet​

<Snippet file="gdo-api-contract-response.json" showLineNumbers />

Integrity Check Report — JSON Schema (v1)GitHub ↗
[SchemaSnippet] Loading schema "zar/integrity_check_report.v1.schema.json" on client...

Input Hub (INPUT_HUB)

Domain: input-hub

Category: data-acquisition

Canonical data acquisition and onboarding domain for structured ESG input, system capability mapping, and signal capture.

Tags: core-module, csrd, esrs, traceability, white-label

Documentation →

Input Hub (INPUT_HUB)

Domain: input-hub

Category: data-acquisition

Canonical data acquisition and onboarding domain for structured ESG input, system capability mapping, and signal capture.

Tags: core-module, csrd, esrs, traceability, white-label

Documentation →

Computation Hub (COMP_HUB)

Domain: computation-hub

Category: analytics-modeling

Canonical computation and modeling domain for ESG calculations, simulations, extrapolation, aggregation, normalization, and decision-grade metric synthesis. Provides governed, auditable compute services to other modules (e.g., Reporting, Risk, Net Zero, ZARA).

Tags: core-module, decision-grade, traceability, white-label, csrd, esrs

Documentation →

Reports & Insights Hub (REPORTS_HUB)

Domain: reports-insights-hub

Category: disclosure-insight

Canonical reporting, disclosure packaging, and insight delivery domain for CSRD/ESRS and related frameworks. Builds stakeholder-ready outputs, integrates trust and assurance signals, and supports structured export formats (e.g., XBRL/iXBRL) with audit-grade traceability.

Tags: core-module, decision-grade, traceability, white-label, csrd, esrs, assurance

Documentation →

Shared Intelligence Stack (SIS)

Domain: shared-intelligence

Category: platform-orchestration

Foundational orchestration and intelligence layer that provides cross-module services for governance, trust, coordination, identity, localization, validation, audit logging, and system-wide interoperability across the ZAYAZ platform.

Tags: core-module, foundational, governance-grade, ai-act-aligned, non-white-label

Documentation →

ZARA — ZAYAZ Autonomous Reporting Assistant (ZARA)

Domain: ai-orchestration

Category: autonomous-reporting

Prompt-driven orchestration module that transforms user intent (e.g., 'Prepare CSRD report for 2025') into governed, auditable workflows across signals, forms, validation, policy generation, task routing, and final disclosure packaging.

Tags: core-module, decision-grade, prompt-to-impact, governance-grade, white-label, csrd, esrs, assurance

Documentation →

ZAAM — ZAYAZ Autonomous Agent Manager (ZAAM)

Domain: ai-agents

Category: agent-execution-management

Governed autonomous agent management module responsible for executing, coordinating, supervising, and constraining AI agents acting on behalf of users, teams, or the platform. ZAAM ensures agent actions remain auditable, role-aware, policy-bound, and aligned with ZAYAZ governance and trust requirements.

Tags: core-module, ai-agents, decision-grade, governance-grade, white-label, ai-act-aligned, audit-first

Documentation →

Risk Intelligence Framework (RIF)

Domain: governance-risk

Category: risk-intelligence

Decision-grade ESG risk identification, quantification, scenario analysis, and escalation.

Tags: core-module, decision-grade, governance-grade, white-label, csrd, esrs

Documentation →

NETZERO — Net-Zero Modeling & Transition Intelligence (NETZERO)

Domain: climate-netzero

Category: transition-modeling

Decision-grade climate transition intelligence module that models baseline emissions, target pathways, abatement levers, cost curves, and uncertainty to support net-zero planning, CSRD/ESRS reporting, and board-level decarbonization strategy with audit-grade traceability.

Tags: core-module, decision-grade, governance-grade, white-label, csrd, esrs-e1, transition-plan, assurance

Documentation →

Verification & Assurance Module (VAM)

Domain: assurance-verification

Category: trust-assurance

Decision-grade verification and assurance domain that orchestrates verifier workflows, evidence handling, trust scoring, audit trails, and assurance packaging across CSRD/ESRS and other frameworks. Enables third-party sign-off, dispute handling, and assurance-ready disclosure outputs with replayable provenance.

Tags: core-module, decision-grade, governance-grade, white-label, assurance, audit-first, csrd, esrs, verifier-network

Documentation →

SEEL — Stakeholder Engagement & Materiality (SEEL)

Domain: materiality-stakeholders

Category: double-materiality

Decision-grade stakeholder engagement and materiality assessment module that orchestrates stakeholder input collection, impact/financial materiality scoring, prioritization logic, and audit-grade evidence trails for CSRD/ESRS double materiality. Produces traceable materiality outcomes that drive reporting scope, risk intelligence, and governance decisions across ZAYAZ.

Tags: core-module, decision-grade, governance-grade, white-label, csrd, esrs, double-materiality, audit-first

Documentation →

EcoWorld Academy (EWA)

Domain: education-training

Category: capability-building

Capability-building and credentialing module that delivers ESG training, assessments, certifications, and learning evidence trails. Links competence, role readiness, and policy adherence to platform trust, workflow permissions, and verifier confidence across ZAYAZ.

Tags: core-module, education, credentialing, governance-grade, white-label, audit-first, capacity-building

Documentation →

TODOs

See Data & Compliance Models - 1. Global Disclosure Ontology (GDO).

Engine Metadata

No registry entry found for pef-me yet.

Input Table Structure

​

compute_executionsDraft
Source file: compute_executions.xlsx
SignalTypeExampleDescription
caller_ipTEXT192.168.14.52, 15.188.110.23Source IP for security / anomaly analysis.
created_atTEXT2025-02-01T10:14:33Z, 2025-02-01T10:14:34ZExecution timestamp (UTC).
dataset_hashesTEXTIPCC-EFDB:sha256-a123bc9f1d92f12398fabc77bb38d99f2c91afbd5311a37d,IEA_SSP:sha256-98231acd19fa0287fb29c8ff093a772cd44aa2bc1faff391, UN_FAO_WATER:sha256-71ab3cd19fa0aa77fb29c8ff093a772cd44aa2135d1ac191Array/map of dataset artifact hashes used (e.g., ['IPCC-EFDB:sha256-...','IEA_SSP:sha256-...']).
error_codeTEXTnull, SCHEMA_VALIDATION_FAILEDMachine-readable error code if status='error' (e.g., SCHEMA_VALIDATION_FAILED).
exec_idstring (pk)01J9Z9K4M2F7W7N4Q7ZJ9V9XGF, 01J9Z9KCN4AMJ5T2W6S5XYF4E9Globally unique execution ID (ULID). Primary key.
inputs_hashTEXTsha256:3fa42eab87cbdd29d8fd0c9a8bd1cb6a543920d8e16c08c28a1c78c9231e4b92, sha256:a128ab769e12ba91bb221b0a8afbd5311a37d4a0e366620eefb4e32976cf81aaCryptographic hash (e.g., sha256:...) of normalized input payload.
latency_msTEXT143, 212End-to-end compute latency in milliseconds.
method_idTEXTMID-00001, MID-00042Method ID (e.g., MID-00001). FK part 1 → ref_compute_method_registry.method_id.
options_hashTEXTsha256:92f8aa769e12b2a3bfb2f2c91afbd5311a37d4a0e366620eefb4e32976c029d2, sha256:81aeaa769e12f89dfbb2f2c91afbd5311a37d4a0e366620eefb4e32976acc2b0Cryptographic hash of normalized options payload.
output_hashTEXTsha256:4cd920fa8912a4627bb9eab32c5fdd314ff2a119e80cc291eabe927caae123ef, sha256:f12920fa8912ff111bb9eab32c5fdd314ff2a119e80cc291eabe927caac44ab1Cryptographic hash of normalized output payload. Optional if execution failed pre-output.
provenance_idTEXTprov-7f892b1a3cdd4e8f8fba2e, prov-c102aa39efdd4694948df2Correlation ID returned to caller; links UI/API to this audit row.
regionTEXTeu-north-1, eu-central-1Region tag where compute ran (e.g., eu-north-1).
statusTEXTok, errorok | error. Final outcome.
storage_refTEXTs3://zayaz-computations/exec/01J9Z9K4M2F7W7N4Q7ZJ9V9XGF/input_output.json, s3://zayaz-computations/exec/01J9Z9KCN4AMJ5T2W6S5XYF4E9/input_output.jsonPointer to sealed blob with full input/output snapshots if retained.
tenant_idTEXTeco-197-123-456-789, eco-044-001-882-331Tenant/customer identifier (used for multi-tenant isolation and audit).
versionTEXT1.1.2, 1.0.0Exact version used (e.g., 1.0.0). FK part 2 → ref_compute_method_registry.version.
Family
auditclassificationcodegeoidmetric
Used by engines
ALTDDAVEDICEMICEPOSTHSEMZARAZSSR
Used by modules
CHUBRIHUBSISZARA

For the exact PEF-ME request format, see .

The Monte Carlo configuration is illustrated in .

Inline badge:​

iso_cc_id Experimental

Table Relationships (PEF-ME Neighborhood)​

Table Graph Explorer

Loading table relationship graph…

E-C-O™ Numbers​

E-C-O Number™ Types

ECO-196-123-456-789

Output Table Structure​

compute_executionsDraft
Source file: compute_executions.xlsx
SignalTypeExampleDescription
caller_ipTEXT192.168.14.52, 15.188.110.23Source IP for security / anomaly analysis.
created_atTEXT2025-02-01T10:14:33Z, 2025-02-01T10:14:34ZExecution timestamp (UTC).
dataset_hashesTEXTIPCC-EFDB:sha256-a123bc9f1d92f12398fabc77bb38d99f2c91afbd5311a37d,IEA_SSP:sha256-98231acd19fa0287fb29c8ff093a772cd44aa2bc1faff391, UN_FAO_WATER:sha256-71ab3cd19fa0aa77fb29c8ff093a772cd44aa2135d1ac191Array/map of dataset artifact hashes used (e.g., ['IPCC-EFDB:sha256-...','IEA_SSP:sha256-...']).
error_codeTEXTnull, SCHEMA_VALIDATION_FAILEDMachine-readable error code if status='error' (e.g., SCHEMA_VALIDATION_FAILED).
exec_idstring (pk)01J9Z9K4M2F7W7N4Q7ZJ9V9XGF, 01J9Z9KCN4AMJ5T2W6S5XYF4E9Globally unique execution ID (ULID). Primary key.
inputs_hashTEXTsha256:3fa42eab87cbdd29d8fd0c9a8bd1cb6a543920d8e16c08c28a1c78c9231e4b92, sha256:a128ab769e12ba91bb221b0a8afbd5311a37d4a0e366620eefb4e32976cf81aaCryptographic hash (e.g., sha256:...) of normalized input payload.
latency_msTEXT143, 212End-to-end compute latency in milliseconds.
method_idTEXTMID-00001, MID-00042Method ID (e.g., MID-00001). FK part 1 → ref_compute_method_registry.method_id.
options_hashTEXTsha256:92f8aa769e12b2a3bfb2f2c91afbd5311a37d4a0e366620eefb4e32976c029d2, sha256:81aeaa769e12f89dfbb2f2c91afbd5311a37d4a0e366620eefb4e32976acc2b0Cryptographic hash of normalized options payload.
output_hashTEXTsha256:4cd920fa8912a4627bb9eab32c5fdd314ff2a119e80cc291eabe927caae123ef, sha256:f12920fa8912ff111bb9eab32c5fdd314ff2a119e80cc291eabe927caac44ab1Cryptographic hash of normalized output payload. Optional if execution failed pre-output.
provenance_idTEXTprov-7f892b1a3cdd4e8f8fba2e, prov-c102aa39efdd4694948df2Correlation ID returned to caller; links UI/API to this audit row.
regionTEXTeu-north-1, eu-central-1Region tag where compute ran (e.g., eu-north-1).
statusTEXTok, errorok | error. Final outcome.
storage_refTEXTs3://zayaz-computations/exec/01J9Z9K4M2F7W7N4Q7ZJ9V9XGF/input_output.json, s3://zayaz-computations/exec/01J9Z9KCN4AMJ5T2W6S5XYF4E9/input_output.jsonPointer to sealed blob with full input/output snapshots if retained.
tenant_idTEXTeco-197-123-456-789, eco-044-001-882-331Tenant/customer identifier (used for multi-tenant isolation and audit).
versionTEXT1.1.2, 1.0.0Exact version used (e.g., 1.0.0). FK part 2 → ref_compute_method_registry.version.
Family
auditclassificationcodegeoidmetric
Used by engines
ALTDDAVEDICEMICEPOSTHSEMZARAZSSR
Used by modules
CHUBRIHUBSISZARA

Link to associates assets (does not work and must be fixed) - Search for DocExamplesMenu.tsx in ChatGPT to find the right spot:​

1. Overview​

Purpose. Compute product-level PEF metrics with uncertainty bounds and traceable EF references.
Scope. SKU/BOM-level; supports BOM interpolation via BIME; outputs are consumable by EPDEX.

We route hazard intelligence through ZHIF, while product footprints are calculated via PEF-ME.

iso_cc_id Stable

!
Draft registry

This signal family is still evolving; avoid production dependencies.

✔
Graph lineage generated

Table dependencies are compiled and in sync with graph_lineage.json.

ℹ️
Good to know

This engine is safe to use with the default profile in SEM.

.zyz-callout--chat

✨
Promt...

How can I reduce GHG by 20% by 2030?

note

Some content with Markdown syntax. Check this api.

tip

Some content with Markdown syntax. Check this api.

info

Some content with Markdown syntax. Check this api.

warning

Some content with Markdown syntax. Check this api.

danger

Some content with Markdown syntax. Check this api.

2. Inputs​

  • nace_code (string) — activity classifier; source: nace table
  • bom_lines[] (array<object>) — material composition & masses; source: BIME
  • energy_mix (object) — grid mix or supplier energy; source: countries/energy or ESU feed
  • geography (string) — ISO3; source: countries
  • ef_refs[] (array<string>, optional) — override EF IDs; source: efdb

JSON Schema contract: /schemas/mice_io.schema.json

3. Outputs​

  • pef_score (number, unit: 'mPt') + uncertainty (p05/p50/p95)
  • hotspots[] (array<object>) — ranked contributors
  • provenance_ref (string) — hash to EF references bundle
  • quality_score (0–1)

4. Algorithms​

  • Material mapping: BOM → EFDB category
  • Energy adjustment: country/plant energy mix application
  • Uncertainty: Monte Carlo over EF distributions; Bayesian update if verifier priors exist
from zayaz.engines.pef_me import compute_pef
result = compute_pef(bom_lines, nace_code="C.25.11", geography="NOR")
print(result["pef_score"], result["uncertainty"]["p95"])

5. Data Dependencies​

6. Telemetry​

Emitted events:

  • engine.invoked, engine.ok, engine.validation_failed, engine.timeout Key metrics:
  • latency_ms, records, p95_uncertainty, quality_score_mean

7. API​

POST /api/v1/engines/pef-me:run
Request/response conform to /schemas/mice_io.schema.json.

8. Validation & Tests​

  • Deterministic fixtures: /tests/fixtures/pef-me/
  • Stochastic CI: 1,000-run MC sanity; assert p50 within tolerance window

9. RBAC & Security​

  • invoke_roles: admin, client.pro, verifier
  • view_roles: admin, verifier

10. Error Model & Fallbacks​

  • If EF missing → fallback to parent EF category with penalty factor
  • If energy mix unknown → default to country baseline + warning

11. Versioning​

  • Spec v0.2; API v1
  • Breaking changes recorded in CHANGELOG.md

12. Open Questions​

  • PCR alignment for sector X
  • Treatment of recycled content credit in BOM lines

JSON Schema (Draft 2020-12)

/src/components/policy-generator.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://zayaz.eco/schemas/policy-generation.json",
  "title": "ZAYAZ Policy Generation Schemas",
  "type": "object",
  "properties": {
    "companyProfile": { "$ref": "#/$defs/CompanyProfile" },
    "policyGenerationSpec": { "$ref": "#/$defs/PolicyGenerationSpec" }
  },
  "required": ["companyProfile", "policyGenerationSpec"],
  "$defs": {
    "CompanyProfile": {
      "title": "CompanyProfile",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "companyId": {
          "type": "string",
          "description": "Internal unique identifier for the company in ZAYAZ."
        },
        "legalName": {
          "type": "string",
          "description": "Official legal name of the company."
        },
        "brandName": {
          "type": "string",
          "description": "Common brand or trade name (if different from legalName)."
        },
        "size": {
          "type": "object",
          "description": "Size metrics and CSRD-related classification.",
          "additionalProperties": false,
          "properties": {
            "employees": {
              "type": "integer",
              "minimum": 0
            },
            "turnoverEUR": {
              "type": "number",
              "minimum": 0
            },
            "balanceSheetTotalEUR": {
              "type": "number",
              "minimum": 0
            },
            "csrdScope": {
              "type": "string",
              "description": "Categorisation relative to CSRD thresholds.",
              "enum": [
                "micro",
                "small",
                "medium",
                "large_undertaking",
                "listed_sme",
                "consolidated_group",
                "non_eu_parent",
                "not_in_scope",
                "unknown"
              ]
            }
          },
          "required": ["csrdScope"]
        },
        "jurisdictions": {
          "type": "array",
          "description": "List of main jurisdictions where the company operates or is regulated. Typically ISO 3166 country codes or higher-level labels like EU.",
          "items": { "type": "string" },
          "uniqueItems": true
        },
        "headquartersCountry": {
          "type": "string",
          "description": "Primary country of headquarters (ISO 3166-1 alpha-2 or alpha-3)."
        },
        "naceCodes": {
          "type": "array",
          "description": "Primary and secondary NACE activity codes.",
          "items": {
            "type": "string",
            "pattern": "^[A-U][0-9]{2}(\\.[0-9]{1,2})?$"
          },
          "uniqueItems": true
        },
        "sectors": {
          "type": "array",
          "description": "Normalised sector tags used by ZAYAZ (ontology can be maintained separately).",
          "items": { "type": "string" },
          "uniqueItems": true
        },
        "languages": {
          "type": "array",
          "description": "Preferred languages for generated content (BCP-47 or ISO 639).",
          "items": { "type": "string" },
          "uniqueItems": true,
          "default": ["en"]
        },
        "esrsApplicability": {
          "type": "object",
          "description": "Per-standard qualitative materiality/priority signal (from SIS/materiality engine).",
          "additionalProperties": false,
          "properties": {
            "E1": { "$ref": "#/$defs/MaterialityLevel" },
            "E2": { "$ref": "#/$defs/MaterialityLevel" },
            "E3": { "$ref": "#/$defs/MaterialityLevel" },
            "E4": { "$ref": "#/$defs/MaterialityLevel" },
            "E5": { "$ref": "#/$defs/MaterialityLevel" },
            "S1": { "$ref": "#/$defs/MaterialityLevel" },
            "S2": { "$ref": "#/$defs/MaterialityLevel" },
            "S3": { "$ref": "#/$defs/MaterialityLevel" },
            "S4": { "$ref": "#/$defs/MaterialityLevel" },
            "G1": { "$ref": "#/$defs/MaterialityLevel" }
          }
        },
        "riskSignals": {
          "type": "object",
          "description": "High-level risk signals that can influence ambition, emphasis and examples.",
          "additionalProperties": false,
          "properties": {
            "climatePhysical": { "$ref": "#/$defs/RiskLevel" },
            "climateTransition": { "$ref": "#/$defs/RiskLevel" },
            "biodiversity": { "$ref": "#/$defs/RiskLevel" },
            "waterStress": { "$ref": "#/$defs/RiskLevel" },
            "supplyChainHumanRights": { "$ref": "#/$defs/RiskLevel" },
            "dataPrivacySecurity": { "$ref": "#/$defs/RiskLevel" },
            "corruptionBribery": { "$ref": "#/$defs/RiskLevel" },
            "productSafety": { "$ref": "#/$defs/RiskLevel" }
          }
        },
        "tonePreferences": {
          "type": "object",
          "description": "Content style and tone preferences to steer policy drafting.",
          "additionalProperties": false,
          "properties": {
            "formality": {
              "type": "string",
              "enum": ["low", "medium", "high"],
              "default": "high"
            },
            "length": {
              "type": "string",
              "enum": ["short", "medium", "long"],
              "default": "medium"
            },
            "audience": {
              "type": "string",
              "enum": ["internal_only", "external_only", "internal_external"],
              "default": "internal_external"
            },
            "readingLevel": {
              "type": "string",
              "description": "Approximate CEFR-style reading level.",
              "enum": ["B1", "B2", "C1", "C2"],
              "default": "B2"
            }
          }
        },
        "contacts": {
          "type": "object",
          "description": "Optional key ESG-related roles used for governance sections.",
          "additionalProperties": false,
          "properties": {
            "esgLeadTitle": { "type": "string" },
            "boardCommitteeName": { "type": "string" },
            "sustainabilityDepartmentName": { "type": "string" }
          }
        },
        "metadata": {
          "type": "object",
          "description": "Free-form extension for internal use (e.g. tags, clusters, scoring).",
          "additionalProperties": true
        }
      },
      "required": ["companyId", "legalName", "size"]
    },

    "PolicyGenerationSpec": {
      "title": "PolicyGenerationSpec",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "requestId": {
          "type": "string",
          "description": "Idempotency / trace ID for this generation request."
        },
        "companyId": {
          "type": "string",
          "description": "Must match CompanyProfile.companyId. Used for logging and storage."
        },
        "templateId": {
          "type": "string",
          "description": "The template to base the policy on (e.g. tpl_policy_env_climate_change_v1)."
        },
        "language": {
          "type": "string",
          "description": "Language for the generated policy content (BCP-47 or ISO 639).",
          "default": "en"
        },
        "targetAudience": {
          "type": "string",
          "enum": ["internal_only", "external_only", "internal_external"],
          "default": "internal_external"
        },
        "policyPurpose": {
          "type": "string",
          "description": "How the policy will be used.",
          "enum": [
            "core_policy",
            "supporting_policy",
            "guideline",
            "procedure",
            "supplier_addendum",
            "customer_facing_statement"
          ],
          "default": "core_policy"
        },
        "strictnessLevel": {
          "type": "string",
          "description": "Desired ambition/strictness of commitments.",
          "enum": ["low", "medium", "medium_high", "high"],
          "default": "medium_high"
        },
        "detailLevel": {
          "type": "string",
          "description": "Granularity of operational detail.",
          "enum": ["principles_only", "balanced", "detailed"],
          "default": "balanced"
        },
        "includeFrameworks": {
          "type": "array",
          "description": "Framework tags that MUST be referenced or at least considered in phrasing.",
          "items": { "type": "string" },
          "uniqueItems": true
        },
        "excludeFrameworks": {
          "type": "array",
          "description": "Framework tags that MUST NOT be referenced explicitly (e.g. not applicable jurisdictions).",
          "items": { "type": "string" },
          "uniqueItems": true
        },
        "jurisdictionOverride": {
          "type": "array",
          "description": "If set, restrict adaptation to these jurisdictions instead of full companyProfile.jurisdictions.",
          "items": { "type": "string" },
          "uniqueItems": true
        },
        "maxWords": {
          "type": "integer",
          "minimum": 200,
          "maximum": 10000,
          "description": "Soft maximum word count for generated content."
        },
        "sectionsToInclude": {
          "type": "array",
          "description": "Optional whitelist of section IDs/names from the template to include.",
          "items": { "type": "string" },
          "uniqueItems": true
        },
        "sectionsToExclude": {
          "type": "array",
          "description": "Optional blacklist of section IDs/names from the template to remove.",
          "items": { "type": "string" },
          "uniqueItems": true
        },
        "enablePlaceholdersFallback": {
          "type": "boolean",
          "description": "If true, the AI is allowed to fill unresolved placeholders with generic but sensible text; if false, unresolved placeholders should be left as-is.",
          "default": false
        },
        "rewriteExistingText": {
          "type": "string",
          "description": "Control how much the AI is allowed to modify baseline template wording.",
          "enum": ["minimal", "moderate", "extensive"],
          "default": "moderate"
        },
        "debugMode": {
          "type": "boolean",
          "description": "If true, engine may attach extra diagnostics (e.g. section mapping, applied frameworks).",
          "default": false
        },
        "metadata": {
          "type": "object",
          "description": "Free-form extension point (e.g. UI origin, userId, scenario).",
          "additionalProperties": true
        }
      },
      "required": ["companyId", "templateId"]
    },

    "MaterialityLevel": {
      "type": "string",
      "enum": ["none", "low", "medium", "high", "unknown"],
      "description": "Qualitative importance / materiality level for a topic."
    },

    "RiskLevel": {
      "type": "string",
      "enum": ["none", "low", "medium", "high", "unknown"],
      "description": "Qualitative risk level classification."
    }
  }
}
GitHub RepoRequest for Change (RFC)