Epic: hREA Dual-DNA Integration

[Soushi888]

Overview

Integrate hREA as the economic data layer for Nondominium using a dual-DNA architecture. hREA handles ValueFlows-compliant economic data (EconomicResource, EconomicEvent, Commitment, Agent) while Nondominium retains its governance and privacy layer (PPR, GovernanceRule, EncryptedProfile).

Strategy doc: documentation/hREA-integration-strategy.md
Integration method: Cross-DNA calls via CallTargetCell::OtherRole("hrea".into()) at the Rust/HDK level — no GraphQL.

Architecture

Nondominium DNA (governance, privacy, PPR)
    │  cross-DNA bridge calls (~5-10ms)
    ▼
hREA DNA (EconomicResource, EconomicEvent, Commitment, ReaAgent)

Decision Matrix

Entity	Decision
EconomicResource	Use hREA
EconomicEvent	Use hREA
Commitment	Use hREA
ResourceSpecification	Hybrid (hREA core + Nondominium extension)
Person/Agent	Hybrid (ReaAgent in hREA + EncryptedProfile in Nondominium)
PPR / GovernanceRule / ValidationReceipt	Keep custom

Phases

Phase 1: Foundation — Person/ReaAgent (current)

• Epic: hREA Dual-DNA Integration #47 Set up hREA git submodule
• hREA Phase 1: Set up hREA git submodule (sprout branch) #48 Configure happ.yaml dual-DNA roles
• hREA Phase 1: Configure happ.yaml with dual-DNA roles #49 Build hREA DNA and include in .webhapp bundle
• hREA Phase 1: Build hREA DNA and include in .webhapp bundle #50 Add hrea_agent_hash field to Person integrity entry
• hREA Phase 1: Add hrea_agent_hash field to Person integrity entry #51 Implement create_rea_agent bridge call in zome_person
• hREA Phase 1: Implement create_rea_agent bridge call in zome_person coordinator #52 Update create_person to create ReaAgent in hREA first
• hREA Phase 1: Update create_person to create ReaAgent in hREA first #53 Write Tryorama tests for dual-DNA person creation
• hREA Phase 1: Write Tryorama tests for dual-DNA person creation #54 Validate get_rea_agents_from_action_hashes cross-DNA read

Phase 2: Resource Lifecycle

• Add hrea_resource_hash link to resource entries
• Implement create_economic_event_with_resource bridge call
• Implement create_rea_resource_specification bridge call
• ResourceSpecificationExtension hybrid pattern
• Dual-read query layer for legacy + hREA resources

Phase 3: Governance Integration

• Implement create_rea_commitment bridge call
• Implement create_rea_economic_event bridge call (with fulfills)
• Wire PPR generation after hREA event creation
• Commitment → Event → PPR end-to-end tests

Phase 4: Production Readiness

• Security audit of cross-DNA capability grants
• Performance benchmarks for bridge call overhead
• Submodule version pinning and upgrade process
• Community deployment guide

Key Risks

Risk	Mitigation
hREA sprout branch API changes	Pin to specific commit SHA
Cross-DNA atomicity (PPR after event)	Explicit failure handling / compensating actions
HDK version mismatch	Verify HDK 0.5.3 compatibility early in Phase 1
Inline struct drift	Import hrea_integrity types as workspace dependency