gaia.core.business_units module

Module: business_units Implements business unit interpretation of simplicial hierarchy for GAIA.

Following Section 3.1 of the theoretical framework, this implements: 1. Business unit interpretation: each n-simplex manages n+1 subordinates 2. Hierarchical communication system between levels 3. Information flow mechanisms up/down the simplicial complex 4. Network of simplices communication instead of linear chains

This provides the organizational interpretation of the mathematical simplicial structure, enabling true hierarchical generative AI.

class gaia.core.business_units.CommunicationType(value)

Bases: Enum

Types of communication in the business unit hierarchy.

DIRECTIVE = 'directive'

REPORT = 'report'

COORDINATION = 'coordination'

FEEDBACK = 'feedback'

classmethod __contains__(member)

Return True if member is a member of this enum raises TypeError if member is not an enum member

note: in 3.12 TypeError will no longer be raised, and True will also be returned if member is the value of a member in this enum

classmethod __getitem__(name)

Return the member matching name.

classmethod __iter__()

Return members in definition order.

classmethod __len__()

Return the number of members (no aliases)

class gaia.core.business_units.BusinessMessage(sender_id, receiver_id, message_type, content, priority=1, timestamp=<factory>)

Bases: object

Message passed between business units.

sender_id: UUID

receiver_id: UUID

message_type: CommunicationType

content: Any

priority: int = 1

timestamp: int

id: UUID

__init__(sender_id, receiver_id, message_type, content, priority=1, timestamp=<factory>)

class gaia.core.business_units.BusinessUnit(simplex, simplicial_functor)

Bases: object

Business unit corresponding to an n-simplex.

Each n-simplex acts as a manager of a business unit that: - Manages n+1 subordinate (n-1)-simplices - Receives directives from superiors - Sends reports to superiors - Coordinates with peer units

__init__(simplex, simplicial_functor)

send_message(receiver_id, message_type, content, priority=1)

Send message to another business unit.

receive_message(message)

Receive message from another business unit.

process_inbox()

Process all messages in inbox.

generate_status_report()

Generate status report for superiors.

send_reports_to_superiors()

Send status reports to all superior units.

issue_directives_to_subordinates(objectives, resource_allocation=None)

Issue directives to subordinate units.

coordinate_with_peers(coordination_type, content)

Coordinate with peer units at the same level.

get_organizational_metrics()

Get metrics about organizational structure and communication.

class gaia.core.business_units.BusinessUnitHierarchy(simplicial_functor)

Bases: object

Complete business unit hierarchy for the simplicial complex.

This implements the organizational interpretation of GAIA where each n-simplex acts as a business unit manager.

__init__(simplicial_functor)

route_message(message)

Route message to target business unit.

process_all_messages()

Process all pending messages in the hierarchy.

cascade_directive_from_top(objectives, resource_allocation=None)

Cascade directive from top-level units down the hierarchy.

collect_reports_to_top()

Collect reports from bottom units up to top of hierarchy.

simulate_business_cycle(objectives, cycles=3)

Simulate complete business cycles with directive cascade and report collection.

Parameters:

• objectives (List[str]) – Business objectives to cascade

• cycles (int) – Number of business cycles to simulate

Returns:

List of cycle reports

Return type:

List[Dict[str, Any]]

get_communication_network_analysis()

Analyze the communication network structure.

visualize_hierarchy()

Create visualization data for the business unit hierarchy.

add_business_unit(unit)

Add a business unit to the hierarchy.

get_unit(unit_id)

Get business unit by ID.

get_units_by_level(level)

Get all business units at a specific level.

gaia.core.business_units.create_business_hierarchy_from_model(model)

Create business unit hierarchy from a GAIA model.

gaia.core.business_units.simulate_organizational_learning(hierarchy, learning_objectives, simulation_steps=10)

Simulate organizational learning process.

This demonstrates how the business unit hierarchy can be used for distributed learning and decision making.