Skip to content

Conversation

@connerkward
Copy link
Owner

@connerkward connerkward commented Jan 26, 2026

Summary

This PR reorganizes the PyBas3 project structure for better clarity and maintainability, updates technical documentation to reflect the current system architecture, and fixes minor documentation errors.

Key Changes

Project Structure Reorganization:

  • Moved participants_db.json and zone_config.json to project root for centralized configuration management
  • Added orchestrator.py as the main entry point for running the full system
  • Reorganized mediapipe/ module with new participant_tracker.py and live_dashboard.py components
  • Expanded pre_render/ documentation with new scripts: generate_chronophoto_variations.py, pose_skeleton_render.py, and CHRONOPHOTO_CONTEXT.md
  • Created td_scripts/ submodule structure with dedicated integration files: td_integration.py, td_participant_manager.py, ndi_discovery.py, and score_watcher.py
  • Added tests/ directory with test_integration.py

Documentation Updates:

  • Updated TECHNICAL_REFERENCE.md directory tree to reflect current file organization and new components
  • Added descriptive comments for key modules (e.g., "pHash UUID assignment", "Real-time monitoring")
  • Fixed typo in CHRONOPHOTO_CONTEXT.md: "passmes" → "passes"
  • Removed empty "User Defined Namespaces" section from openmemory.md
  • Clarified component descriptions in openmemory.md to match new structure

Implementation Details

  • Configuration files (participants_db.json, zone_config.json) are now at the root level for easier access by the orchestrator
  • The new participant_tracker.py module handles UUID assignment via pHash, improving separation of concerns
  • TouchDesigner integration is now properly modularized with dedicated manager and discovery components
  • Documentation now accurately reflects the multi-process architecture (MediaPipe → Scoring → TouchDesigner)

Note

Updates documentation to reflect the new project layout and clarify module responsibilities.

  • Refreshes TECHNICAL_REFERENCE.md project tree with root-level orchestrator.py, participants_db.json, zone_config.json, new mediapipe components (participant_tracker.py, live_dashboard.py), expanded pre_render/ scripts, td_scripts/ integration files, and tests/
  • Adds descriptive notes for modules (e.g., pHash UUID assignment, real-time monitoring) and clarifies pipeline and IO paths
  • Adds pre_render/CHRONOPHOTO_CONTEXT.md and fixes typo (“passmes” → “passes”)
  • Cleans up openmemory.md by removing an empty section and aligning component/pattern descriptions with the new structure

Written by Cursor Bugbot for commit 82ce5da. This will update automatically on new commits. Configure here.

- Update TECHNICAL_REFERENCE.md project structure to reflect actual file locations
- Add missing pre_render scripts to project structure
- Fix typo in CHRONOPHOTO_CONTEXT.md (passmes -> passes)
- Remove empty User Defined Namespaces section from openmemory.md
@connerkward connerkward merged commit 957d8dd into main Jan 26, 2026
1 check passed
@connerkward connerkward deleted the claude/review-documentation-5ki2t branch January 26, 2026 02:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants