refactor: modularity fixes + plugin registry + compiled research

purpose_agent/orchestrator.py

@@ -277,7 +277,7 @@ class Orchestrator:
         )
 
         # Load existing heuristics into Actor memory
-        self._sync_memory()
+        self.sync_memory()
 
     # ------------------------------------------------------------------
     # Main Task Loop
@@ -427,7 +427,7 @@ class Orchestrator:
 
         # Post-task processing
         result = TaskResult(trajectory=trajectory, final_state=current_state)
-        self._post_task(trajectory, relevant_experiences)
+        self.post_task(trajectory, relevant_experiences)
 
         logger.info(f"═══ Task complete ═══\n{result.summary()}")
         return result
@@ -436,12 +436,17 @@ class Orchestrator:
     # Post-Task: Experience Storage + Optimization
     # ------------------------------------------------------------------
 
-    def _post_task(
+    def post_task(
         self,
         trajectory: Trajectory,
-        used_experiences: list[Any],
+        used_experiences: list[Any] | None = None,
     ) -> None:
-        """Post-task processing: store trajectory, maybe optimize, sync memory."""
+        """Post-task processing: store trajectory, maybe optimize, sync memory.
+        
+        Public API — called by HITLOrchestrator, AsyncOrchestrator, and
+        any custom orchestration wrapper after a task completes.
+        """
+        used_experiences = used_experiences or []
 
         # Store in experience replay
         record = self.experience_replay.add(trajectory)
@@ -480,10 +485,14 @@ class Orchestrator:
         self.optimizer.optimize(top_trajectories)
 
         # Sync updated heuristics to Actor memory
-        self._sync_memory()
+        self.sync_memory()
 
-    def _sync_memory(self) -> None:
-        """Push current heuristic library to Actor's memory tiers."""
+    def sync_memory(self) -> None:
+        """Push current heuristic library to Actor's memory tiers.
+        
+        Public API — call after manually modifying the heuristic library
+        (e.g., human-injected heuristics via HITL).
+        """
         self.actor.update_strategic_memory(
             self.optimizer.get_heuristics_by_tier(MemoryTier.STRATEGIC)
         )