# Roles & Permissions

# Role Taxonomy Overview

<style id="bkmrk-body%7Bfont-family%3A-ap">
body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;color:#1a1a2e;line-height:1.7}
h1{font-size:1.6em;font-weight:800;margin:0 0 6px}
h2{font-size:1.15em;font-weight:700;margin:28px 0 10px;border-bottom:2px solid #E2E8F0;padding-bottom:6px}
h3{font-size:1em;font-weight:700;margin:20px 0 8px;color:#334155}
p{margin:0 0 12px}
.header{padding:20px 24px;border-radius:10px;margin-bottom:24px;color:#fff}
.header h1{color:#fff;margin:0 0 4px}
.header .tagline{font-size:.92em;opacity:.85;margin:0}
.header .badge{display:inline-block;background:rgba(255,255,255,.2);font-size:.75em;
  font-weight:700;padding:2px 10px;border-radius:99px;margin-top:8px;letter-spacing:.06em}
.card-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:12px;margin:16px 0}
.card{border-radius:8px;padding:14px 16px;border:1.5px solid}
.card h4{font-size:.9em;font-weight:700;margin:0 0 5px}
.card p{font-size:.85em;margin:0;color:#475569;line-height:1.5}
.rule-block{border-radius:8px;padding:14px 16px;border-left:4px solid;margin:12px 0}
.rule-id{display:inline-block;font-size:.78em;font-weight:700;padding:2px 8px;
  border-radius:99px;margin-bottom:6px;letter-spacing:.05em}
.rule-title{font-size:.95em;font-weight:700;margin:0 0 5px}
.rule-body{font-size:.88em;color:#334155;margin:0 0 6px}
.rule-impl{font-size:.82em;color:#64748B;font-style:italic;border-top:1px solid rgba(0,0,0,.08);
  padding-top:6px;margin-top:6px}
.tag{display:inline-block;font-size:.78em;padding:2px 9px;border-radius:99px;
  margin:2px;font-weight:600}
.tag-grid{margin:12px 0}
table{width:100%;border-collapse:collapse;margin:16px 0;font-size:.88em}
th{background:#1a1a2e;color:#fff;padding:8px 12px;text-align:left;font-weight:600}
td{padding:8px 12px;border-bottom:1px solid #E2E8F0;vertical-align:top}
tr:nth-child(even) td{background:#F8FAFC}
.perm-yes{color:#15803D;font-weight:700}
.perm-no{color:#B91C1C;font-weight:700}
.perm-special{color:#6D28D9;font-weight:700}
.cross-link{background:#EFF6FF;border:1px solid #93C5FD;border-radius:7px;
  padding:10px 14px;font-size:.88em;color:#1E40AF;margin:16px 0}
.cross-link a{color:#1E40AF;font-weight:600}
.info-box{border-radius:8px;padding:14px 16px;margin:16px 0;font-size:.88em;line-height:1.6}
.stack-layer{border-radius:8px;padding:12px 16px;border:1.5px solid;margin:10px 0}
.layer-num{display:inline-block;width:24px;height:24px;border-radius:50%;
  text-align:center;line-height:24px;font-size:.75em;font-weight:700;color:#fff;margin-right:8px}
.meta{font-size:.78em;color:#94A3B8;margin-top:24px;padding-top:12px;
  border-top:1px solid #E2E8F0}
</style></head><body><div class="header" id="bkmrk-role-taxonomy-six-ro" style="background:#0E7490"># Role Taxonomy

Six roles. Each is bounded by a credential. AI agents are first-class participants.

 <span class="badge">Roles &amp; Permissions · R-00</span></div>Every actor in the framework — human, organisation, or AI agent — operates under one of six defined roles. Roles are not just labels: each role is a Verifiable Credential issued by CTH (or by the community for the Sovereign role) that gates API permissions. You cannot perform an action without the credential that authorises it.

## Permissions Matrix

<table id="bkmrk-permission-submitter"> <tr> <th>Permission</th> <th>Submitter</th><th>Validator</th><th>Sovereign</th> <th>Steward</th><th>Auditor</th><th>AI Agent</th> </tr> <tr> <td>Submit polygon / emissions data</td> <td class="perm-yes">✅ Own data</td><td class="perm-no">—</td><td class="perm-no">—</td> <td class="perm-no">—</td><td class="perm-no">—</td><td class="perm-special">⚡ If delegated by Submitter</td> </tr> <tr> <td>Issue VALIDATED event / DCC</td> <td class="perm-no">—</td><td class="perm-yes">✅</td><td class="perm-no">—</td> <td class="perm-no">—</td><td class="perm-no">—</td><td class="perm-special">⚡ If delegated by Validator</td> </tr> <tr> <td>Issue / revoke FPIC credential</td> <td class="perm-no">—</td><td class="perm-no">—</td><td class="perm-yes">✅</td> <td class="perm-no">—</td><td class="perm-no">—</td><td class="perm-no">—</td> </tr> <tr> <td>Read own submitted data</td> <td class="perm-yes">✅</td><td class="perm-yes">✅</td><td class="perm-yes">✅ (own territory)</td> <td class="perm-yes">✅</td><td class="perm-yes">✅ Public only</td><td class="perm-special">⚡ Delegated scope</td> </tr> <tr> <td>Read all non-restricted data</td> <td class="perm-no">—</td><td class="perm-yes">✅</td><td class="perm-yes">✅ Own territory</td> <td class="perm-yes">✅</td><td class="perm-yes">✅ Public only</td><td class="perm-special">⚡ Public scope</td> </tr> <tr> <td>Manage schemas / framework</td> <td class="perm-no">—</td><td class="perm-no">—</td><td class="perm-no">—</td> <td class="perm-yes">✅</td><td class="perm-no">—</td><td class="perm-no">—</td> </tr> <tr> <td>Call POST /policy/evaluate</td> <td class="perm-yes">✅</td><td class="perm-yes">✅</td><td class="perm-yes">✅</td> <td class="perm-yes">✅</td><td class="perm-yes">✅</td><td class="perm-yes">✅ Mandatory before write</td> </tr> <tr> <td>Override FPIC consent block</td> <td class="perm-no">🚫 Never</td><td class="perm-no">🚫 Never</td><td class="perm-no">N/A</td> <td class="perm-no">🚫 Never</td><td class="perm-no">🚫 Never</td><td class="perm-no">🚫 Never</td> </tr></table>

<div class="info-box" id="bkmrk-key-principle%3A-an-ai" style="background:#F0F9FF;border:1.5px solid #67E8F9"> **Key principle:** An AI agent inherits the permissions of the human role that delegated it — never more. An agent acting for a Submitter can write polygon data but cannot validate it. Agents cannot combine permissions from multiple delegating roles. </div><div class="meta" id="bkmrk-roles-%26-permissions-">Roles &amp; Permissions · R-00 · Framework version 1.0 · CleantechHUB · CC-BY 4.0</div>

# Data Submitter

<div id="bkmrk-%F0%9F%93%A4-data-submitter-sub" style="border-top:5px solid #2c7a4b;border-radius:10px;padding:24px;background:#eaf5ef;margin-bottom:24px"><div style="display:flex;align-items:center;gap:14px;margin-bottom:16px"> <span style="font-size:2.4em">📤</span><div>## Data Submitter

 <span style="background:#2c7a4b;color:#fff;padding:3px 12px;border-radius:12px;font-size:0.8em">SUBMITTER</span> </div></div>**Who holds this role:** Coffee cooperatives, smallholder farmers, IoT sensor operators, KoboToolbox field agents

<div style="display:grid;grid-template-columns:1fr 1fr;gap:16px;margin:16px 0"><div style="background:#fff;border-radius:8px;padding:16px">#### ✅ Permitted Actions

- Submit parcel GPS polygons via KoboToolbox or direct API
- Attach evidence documents (photos, invoices, lab certificates)
- View own submission status and validation results
- Request data deletion for own submissions

 </div><div style="background:#fff;border-radius:8px;padding:16px">#### 🚫 Prohibited Actions

- Validate other parties' data
- Access other submitters' raw data
- Modify or delete after ledger entry
- Override FPIC flags

 </div></div><div style="background:#fff;border-radius:8px;padding:14px;margin-top:12px"> **Required Credential:** `cth:SubmitterCredential`</div><div style="margin-top:14px;font-size:0.9em;color:#555">Issued after identity verification + GDPR/habeas-data consent; expires 12 months; renewable</div></div>

# Accredited Validator

<div id="bkmrk-%F0%9F%94%AC-accredited-validat" style="border-top:5px solid #1a6b8a;border-radius:10px;padding:24px;background:#e8f4f8;margin-bottom:24px"><div style="display:flex;align-items:center;gap:14px;margin-bottom:16px"> <span style="font-size:2.4em">🔬</span><div>## Accredited Validator

 <span style="background:#1a6b8a;color:#fff;padding:3px 12px;border-radius:12px;font-size:0.8em">VALIDATOR</span> </div></div>**Who holds this role:** IDEAM-certified labs, SGS/Bureau Veritas auditors, satellite data providers (Planet, Mapbiomas), academic partners

<div style="display:grid;grid-template-columns:1fr 1fr;gap:16px;margin:16px 0"><div style="background:#fff;border-radius:8px;padding:16px">#### ✅ Permitted Actions

- Cryptographically sign validation results as W3C VC 2.0 assertions
- Issue Digital Conformity Credentials (UNTP DCC)
- Access raw submission data for assigned parcels
- Flag data quality issues; trigger R-SUB-03

 </div><div style="background:#fff;border-radius:8px;padding:16px">#### 🚫 Prohibited Actions

- Self-certify own submissions
- Access data outside assigned scope
- Modify ledger entries after signing
- Issue credentials outside accreditation scope

 </div></div><div style="background:#fff;border-radius:8px;padding:14px;margin-top:12px"> **Required Credential:** `cth:ValidatorCredential`</div><div style="margin-top:14px;font-size:0.9em;color:#555">Issued by CTH Accreditation Committee; requires ISO 17025 or equivalent; 2-year term; public registry</div></div>

# Community Sovereign

<div id="bkmrk-%F0%9F%A4%9D-community-sovereig" style="border-top:5px solid #6b3a9e;border-radius:10px;padding:24px;background:#f3eef9;margin-bottom:24px"><div style="display:flex;align-items:center;gap:14px;margin-bottom:16px"> <span style="font-size:2.4em">🤝</span><div>## Community Sovereign

 <span style="background:#6b3a9e;color:#fff;padding:3px 12px;border-radius:12px;font-size:0.8em">SOVEREIGN</span> </div></div>**Who holds this role:** Indigenous territorial councils (cabildos), Afro-Colombian community boards (consejos comunitarios), campesino associations with collective land title

<div style="display:grid;grid-template-columns:1fr 1fr;gap:16px;margin:16px 0"><div style="background:#fff;border-radius:8px;padding:16px">#### ✅ Permitted Actions

- Grant or revoke FPIC for territory-level data collection
- Set purpose limitations on community data (e.g. EUDR only, no carbon market use)
- Require benefit-sharing terms before validator access
- Audit all uses of community data at any time

 </div><div style="background:#fff;border-radius:8px;padding:16px">#### 🚫 Prohibited Actions

- Submit individual parcel data (use Data Submitter role)
- Override individual member consent
- Transfer sovereignty credential to another entity without community resolution

 </div></div><div style="background:#fff;border-radius:8px;padding:14px;margin-top:12px"> **Required Credential:** `cth:CommunityCredential`</div><div style="margin-top:14px;font-size:0.9em;color:#555">Issued after verification of legal collective title or territorial recognition; held by council secretary; multi-sig (3-of-5 council members) for revocation. The Community Sovereign's FPIC block is structural — enforced at Postgres row-level security below OPA. No board vote, no emergency patch, no API call can override it. This is non-negotiable.</div></div>

# CTH Data Steward

<div id="bkmrk-%F0%9F%9B%A1%EF%B8%8F-cth-data-steward-" style="border-top:5px solid #b35c00;border-radius:10px;padding:24px;background:#fdf3e7;margin-bottom:24px"><div style="display:flex;align-items:center;gap:14px;margin-bottom:16px"> <span style="font-size:2.4em">🛡️</span><div>## CTH Data Steward

 <span style="background:#b35c00;color:#fff;padding:3px 12px;border-radius:12px;font-size:0.8em">STEWARD</span> </div></div>**Who holds this role:** CleantechHUB staff members with explicit stewardship assignment (not all CTH staff)

<div style="display:grid;grid-template-columns:1fr 1fr;gap:16px;margin:16px 0"><div style="background:#fff;border-radius:8px;padding:16px">#### ✅ Permitted Actions

- Manage framework configuration and standards versions
- Onboard and offboard validators (with Governance Board approval)
- Execute emergency patches (R-CHG-03) within 48h window
- Run compliance exports (EUDR DDS, CSRD reports)
- Access all data for governance purposes only

 </div><div style="background:#fff;border-radius:8px;padding:16px">#### 🚫 Prohibited Actions

- Use data for CTH commercial purposes
- Override FPIC blocks
- Approve own stewardship actions without peer review
- Modify ledger entries

 </div></div><div style="background:#fff;border-radius:8px;padding:14px;margin-top:12px"> **Required Credential:** `cth:StewardCredential`</div><div style="margin-top:14px;font-size:0.9em;color:#555">Issued internally; requires Governance Board nomination; logged access; annual review</div></div>

# Regulator / Auditor

<div id="bkmrk-%F0%9F%93%8B-regulator-%2F-audito" style="border-top:5px solid #555;border-radius:10px;padding:24px;background:#f5f5f5;margin-bottom:24px"><div style="display:flex;align-items:center;gap:14px;margin-bottom:16px"> <span style="font-size:2.4em">📋</span><div>## Regulator / Auditor

 <span style="background:#555;color:#fff;padding:3px 12px;border-radius:12px;font-size:0.8em">AUDITOR</span> </div></div>**Who holds this role:** EU customs authorities (EUDR), DIAN (Colombia), ANLA, IDEAM, financial supervisors (CVM, CNBV), carbon registry auditors

<div style="display:grid;grid-template-columns:1fr 1fr;gap:16px;margin:16px 0"><div style="background:#fff;border-radius:8px;padding:16px">#### ✅ Permitted Actions

- Read-only access to compliance packages (EUDR DDS, CBAM declarations, CSRD reports)
- Verify ledger integrity via rolling SHA-256 hashes
- Request data lineage traces for specific parcels
- Receive automated compliance alerts

 </div><div style="background:#fff;border-radius:8px;padding:16px">#### 🚫 Prohibited Actions

- Access raw submissions beyond compliance package scope
- Request personal data beyond what's in compliance outputs
- Modify any data or metadata

 </div></div><div style="background:#fff;border-radius:8px;padding:14px;margin-top:12px"> **Required Credential:** `cth:AuditorCredential`</div><div style="margin-top:14px;font-size:0.9em;color:#555">Issued upon presentation of official regulatory mandate; time-limited to audit scope; zero data retention after audit closes</div></div>

# AI Agent

<div id="bkmrk-%F0%9F%A4%96-ai-agent-agent-who" style="border-top:5px solid #0d6efd;border-radius:10px;padding:24px;background:#e7f0ff;margin-bottom:24px"><div style="display:flex;align-items:center;gap:14px;margin-bottom:16px"> <span style="font-size:2.4em">🤖</span><div>## AI Agent

 <span style="background:#0d6efd;color:#fff;padding:3px 12px;border-radius:12px;font-size:0.8em">AGENT</span> </div></div>**Who holds this role:** Claude instances, automated pipeline scripts, Pipedream workflows, any non-human principal acting on behalf of a credentialed human

<div style="display:grid;grid-template-columns:1fr 1fr;gap:16px;margin:16px 0"><div style="background:#fff;border-radius:8px;padding:16px">#### ✅ Permitted Actions

- Submit data on behalf of delegating human (inherits human's permissions only)
- Read permitted datasets for analysis
- Call POST /policy/evaluate before any write operation
- Generate PROV-O provenance records for every action

 </div><div style="background:#fff;border-radius:8px;padding:16px">#### 🚫 Prohibited Actions

- Hold independent credentials (credential must be delegated from a human DID)
- Exceed the permission scope of the delegating human
- Bypass POST /policy/evaluate
- Take any action when FPIC block is active — absolute prohibition

 </div></div><div style="background:#fff;border-radius:8px;padding:14px;margin-top:12px"> **Required Credential:** `cth:AgentCredential (delegated from human DID)`</div><div style="margin-top:14px;font-size:0.9em;color:#555">Agent inherits the delegating human's DID permissions — never more. Every agent action creates a PROV-O record naming the delegating human DID and the agent ID. FPIC block is enforced at DB row-level security — OPA never even sees the request.</div></div>