Files
EricRollei-AAA_Metadata_System/config.json
T
Eric Rollei 1f9fa9b670 Add backward compatibility, XMP regions, per-node hooks toggle, and enhancements
Major Features:
- Backward compatibility: VALIDATE_INPUTS handles old boolean True/False values for enable_runtime_hooks parameter
- Phase 3: XMP region metadata with MWG-RS compliance (faces, areas, coordinates, extensions)
- Phase 4.4: Per-node UI toggle for runtime hooks (dropdown: Auto/Enabled/Disabled)
- Runtime hooks enhancements: performance tracking, disagreement logging, configurable limits

New Files:
- config.json: Configuration file for runtime hooks and metadata settings
- eric_metadata/hooks/runtime_capture.py: Runtime hook infrastructure
- eric_metadata/utils/config.py: Configuration loader with priority system
- eric_metadata/utils/version.py: Version helper for generated_by labels
- eric_metadata/utils/a1111.py: Automatic1111 parameter string generation
- eric_metadata/utils/jpeg_fallback.py: 4-stage JPEG metadata fallback
- eric_metadata/workflow/: Workflow parsing and generation helpers
- tests/test_backward_compatibility.py: 7 tests for parameter migration
- tests/test_xmp_regions.py: 6 tests for XMP region round-trip
- tests/test_per_node_runtime_hooks.py: 9 tests for per-node toggle

Documentation:
- CONFIG_GUIDE.md: Configuration options and usage
- RUNTIME_HOOKS_QUICK_REFERENCE.md: Quick reference for runtime hooks
- RUNTIME_HOOKS_ENHANCEMENTS_SUMMARY.md: Detailed enhancement documentation
- SAFE_RUNTIME_HOOKS_RESEARCH.md: Safety analysis and validation
- edit_log.md: Complete change history

Test Results: All 143 tests passing
- 7 backward compatibility tests
- 6 XMP region tests
- 9 per-node toggle tests
- 17 runtime hooks enhancement tests
- 104 existing tests

Breaking Changes: None - fully backward compatible
2025-11-20 01:26:04 -08:00

29 lines
1.2 KiB
JSON

{
"_comment": "Configuration for AAA Metadata System",
"_version": "1.0.0",
"runtime_hooks": {
"enabled": false,
"_comment": "Enable runtime execution hooks to capture actual node execution data. This provides more accurate metadata but adds ~0.2% overhead. Requires ComfyUI restart to take effect. Alternative: Set environment variable AAA_METADATA_ENABLE_HOOKS=true",
"log_disagreements": false,
"_comment_disagreements": "Log when parser and runtime hooks provide different values for the same field. Useful for debugging conditional logic and switch nodes.",
"log_performance": false,
"_comment_performance": "Log performance metrics for hook overhead. Shows timing data for each hook execution when debug.enabled is also true.",
"inline_size_limit_kb": 32,
"_comment_inline_limit": "Maximum size in KB for inline runtime data before moving to sidecar file. Default 32KB. Increase if you want more runtime data embedded directly in images."
},
"debug": {
"enabled": false,
"_comment": "Enable detailed debug logging for troubleshooting"
},
"metadata": {
"enable_hash_cache": true,
"_comment": "Cache model/LoRA hash calculations for performance (~1000x faster on subsequent runs)"
}
}