Add Missing TODO: Extract Global Variables in Dependency Resolution

[jeremymanning]

Overview

The dependency resolution system has a TODO marker indicating missing functionality for extracting global variables.

Current Status

Location: clustrix/dependency_resolution.py:359

Current Code:

global_variables={},  # TODO: Extract global variables

Problem Description

The dependency resolution system is not currently extracting and preserving global variables that functions may depend on. This could cause runtime errors when functions are executed remotely and expect certain global variables to be available.

Impact

• Functions that reference global variables may fail during remote execution
• Missing global context could lead to NameError exceptions
• Incomplete dependency analysis for complex functions

Implementation Requirements

1. Global Variable Detection

• Analyze function code to identify global variable references
• Distinguish between built-in globals and user-defined globals
• Handle nested function scopes appropriately

2. Global Variable Extraction

• Extract values of referenced global variables
• Handle serializable and non-serializable globals appropriately
• Provide fallback mechanisms for complex global objects

3. Remote Global Setup

• Reconstruct global variable environment on remote systems
• Handle global variable conflicts and namespacing
• Ensure proper global variable lifecycle management

Technical Considerations

AST Analysis for Global References

import ast

def extract_global_references(func):
    """Extract global variable references from function AST."""
    source = inspect.getsource(func)
    tree = ast.parse(source)
    # Analyze for global name references
    # Return list of global variable names

Global Variable Serialization

• Need to handle different types of global objects
• Consider circular references in global variables
• Handle module-level imports and functions

Testing Requirements

• Test functions with global variable dependencies
• Test nested global variable references
• Test global variable serialization/deserialization
• Test conflict resolution for global variables
• Test performance impact of global variable extraction

Related Components

• clustrix/dependency_resolution.py - Main implementation location
• clustrix/utils.py - Function serialization utilities
• clustrix/executor.py - Remote execution environment setup

Acceptance Criteria

• TODO comment is resolved with actual implementation
• Global variables are correctly identified for functions
• Global variables are properly serialized and transferred
• Remote execution environment includes necessary globals
• All existing functionality continues to work
• Comprehensive test coverage for global variable handling

Priority: Medium
Complexity: Medium-High

Source: Content found during codebase TODO/FIXME scan in Issue #74 content preservation automation.