Update journal entries and documentation for LangGraph CLI debugging and environment variables

- Modify journal entries for April 11, 16, and 17, enhancing references to LangGraph CLI debugging in PyCharm and handling blocking errors in async code.
- Add new documentation pages for debugging in PyCharm and the BG_JOB_ISOLATED_LOOPS environment variable, providing detailed instructions and best practices.
- Remove outdated debugging documentation to streamline resources.

Author: codekiln

journals/2025_04_11.md

@@ -2,5 +2,5 @@
 	- #Discovered [[Logseq/Plugin/logseq-fenced-code-plus]] has support for [[Mermaid]]. Too bad plugins aren't supported when using [[Logseq/Publish]] to web
 - ## Langchain Ecosystem
 	- #Filed
-		- [[langgraph/CLI/How To/Debug/in PyCharm]]
+		- [[langgraph/CLI/dev/How To/Debug/PyCharm]]
 		- [[langgraph/CLI/dev/How To/Handle blocking errors in async code]]

journals/2025_04_16.md

@@ -1,4 +1,4 @@
 ## Python
 	- [[Py/PEP/570 Python Positional-Only Parameters]]
-	- ### Async
--
+	- ### Async and LangChain Ecosystem
+		- [[langgraph/CLI/dev/How To/Handle blocking errors in async code]]

journals/2025_04_17.md

@@ -0,0 +1,5 @@
+## Langchain Ecosystem
+	- #Updated
+		- [[langgraph/CLI/dev/How To/Debug/PyCharm]]
+	- #Filed
+		- [[langgraph/CLI/EnvVar/BG_JOB_ISOLATED_LOOPS]]

pages/PyCharm___Debug___Attach to Process.md

@@ -0,0 +1,9 @@
+# [Attach to process | PyCharm Documentation](https://www.jetbrains.com/help/pycharm/attach-to-process.html)
+	- ## Summary
+		- > PyCharm provides a way to attach the debugger to a Python local process, while running a Python script launched either from your operating system or using the PyCharm terminal, but NOT in the debug mode. Note that you cannot attach to a remote process.
+	- ## How To
+		- Run | Attach to Process - Option+Shift+F5  (`⌥⇧F5`) #Keyshort
+			- alternatively, use [[PyCharm/Keyshort/Find Action]] and search for Attach to Process
+		- type the name of the process
+		- hit enter
+	-

pages/PyCharm___Keyshort___Find Action.md

@@ -0,0 +1,4 @@
+tags:: [[Keyshort]]
+
+- # [Find Action](https://www.jetbrains.com/help/pycharm/mastering-keyboard-shortcuts.html)
+	- | Cmd+Shift+A (`⌘⇧A`) | [Find Action](https://www.jetbrains.com/help/pycharm/searching-everywhere.html#find_action) - Find a command and execute it, open a tool window, or search for a setting. |

pages/langgraph___CLI___EnvVar___BG_JOB_ISOLATED_LOOPS.md

@@ -0,0 +1,4 @@
+# [BG_JOB_ISOLATED_LOOPS](https://langchain-ai.github.io/langgraph/cloud/reference/env_var/?h=bg_job_isolated_loops#bg_job_isolated_loops)
+	- Set ==BG_JOB_ISOLATED_LOOPS== to `True` to execute background runs in an isolated event loop separate from the serving API event loop.
+	- This environment variable should be set to `True` if the implementation of a graph/node contains synchronous code. In this situation, the synchronous code will block the serving API event loop, which may cause the API to be unavailable. A symptom of an unavailable API is continuous application restarts due to failing health checks.
+	- Defaults to `False`.

pages/langgraph___CLI___How To___Debug___in PyCharm.md

@@ -0,0 +1,63 @@
+# How to use a #Debugger with `langgraph dev` in [[PyCharm]]
+	- ## Partially Working
+		- ### Creating a [[PyCharm/Run Configuration]] for `langgraph-dev --allow-blocking`
+			- [[langgraph/GitHub/Discussion/25/04/How to use langgraph dev in a PyCharm Debugger]]
+				- #### [[My Notes]]
+					- Marked as "partially working" because the `--allow-blocking` argument is needed because [[pydevd]] uses blocking operations to resolve symlinks to files, which triggers [[langgraph]]'s detection using [[Py/Lib/blockbuster]]
+				- #### PyCharm Run Configuration parameters
+					- **Run Configuration Type** - Python
+					- **Virtual Environment** - Select your project's virtual environment
+					- **Run Configuration Subtype** - `script`
+					- **Script Path**: absolute path to the `langgraph` executable within the virtualenv, found with `which langgraph`
+						- (anyone know how to make this more dynamic? just putting in `langgraph` yields `FileNotFoundError: [Errno 2] No such file or directory: 'langgraph'`
+					- **Script Parameters**: `dev --allow-blocking`
+						- no need for `--debug-port`, which is for  [[Py/debugpy]]  instead of PyCharm's  [[pydevd]]
+	- ## Not Working
+		- ### Attach to Process
+			- #### 1 - `langgraph dev` in a terminal, then use [[PyCharm/Debug/Attach to Process]]
+				- #### To reproduce
+					- in a terminal - run `langgraph dev`
+					- initiate [[PyCharm/Debug/Attach to Process]]
+				- #### Expected Behavior - PyCharm is able to debug an external process
+				- #### Actual Behavior - `error: Execution was interrupted, reason: signal SIGSTOP`.
+					- ```
+					  Attaching to a process with PID=85,887
+					  /path/to/python/env/bin/python /Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/attach_pydevd.py --port 59663 --pid 85887
+					  Running: lldb --no-lldbinit --script-language Python -o 'process attach --pid 85887' -o 'command script import "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/linux_and_mac/lldb_prepare.py"' -o 'load_lib_and_attach "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/attach.dylib" 0 "import sys;sys.path.append(\"/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev\");sys.path.append(\"/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process\");import attach_script;attach_script.attach(port=59663, host=\"127.0.0.1\", protocol=\"\", debug_mode=\"\");" 0' -o 'process detach' -o 'script import os; os._exit(1)'
+					  (lldb) process attach --pid 85887
+					  Process 85887 stopped
+					  * thread #1, queue = 'com.apple.main-thread', stop reason = signal SIGSTOP
+					      frame #0: 0x00000001935353c8 libsystem_kernel.dylib`__semwait_signal + 8
+					  libsystem_kernel.dylib`__semwait_signal:
+					  ->  0x1935353c8 <+8>:  b.lo   0x1935353e8               ; <+40>
+					      0x1935353cc <+12>: pacibsp 
+					      0x1935353d0 <+16>: stp    x29, x30, [sp, #-0x10]!
+					      0x1935353d4 <+20>: mov    x29, sp
+					  Target 0: (python3.12) stopped.
+					  Executable module set to "/path/to/python/3.12.1/bin/python3.12".
+					  Architecture set to: arm64-apple-macosx-.
+					  (lldb) command script import "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/linux_and_mac/lldb_prepare.py"
+					  (lldb) load_lib_and_attach "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/attach.dylib" 0 "import sys;sys.path.append(\"/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev\");sys.path.append(\"/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process\");import attach_script;attach_script.attach(port=59663, host=\"127.0.0.1\", protocol=\"\", debug_mode=\"\");" 0
+					  /Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/attach.dylib
+					  success
+					  import sys;sys.path.append("/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev");sys.path.append("/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process");import attach_script;attach_script.attach(port=59663, host="127.0.0.1", protocol="", debug_mode="");
+					  error: error: Execution was interrupted, reason: signal SIGSTOP.
+					  The process has been returned to the state before expression evaluation.
+					  (lldb) process detach
+					  Process 85887 detached
+					  (lldb) script import os; os._exit(1)
+					  Traceback (most recent call last):
+					    File "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/attach_pydevd.py", line 79, in <module>
+					      main(process_command_line(sys.argv[1:]))
+					    File "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/attach_pydevd.py", line 74, in main
+					      add_code_to_python_process.run_python_code(
+					    File "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/add_code_to_python_process.py", line 533, in run_python_code_mac
+					      subprocess.check_call(' '.join(cmd), shell=True, env=env)
+					    File "/path/to/python/3.12.1/lib/python3.12/subprocess.py", line 413, in check_call
+					      raise CalledProcessError(retcode, cmd)
+					  subprocess.CalledProcessError: Command 'lldb --no-lldbinit --script-language Python -o 'process attach --pid 85887' -o 'command script import "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/linux_and_mac/lldb_prepare.py"' -o 'load_lib_and_attach "/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process/attach.dylib" 0 "import sys;sys.path.append(\"/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev\");sys.path.append(\"/Applications/PyCharm.app/Contents/plugins/python-ce/helpers/pydev/pydevd_attach_to_process\");import attach_script;attach_script.attach(port=59663, host=\"127.0.0.1\", protocol=\"\", debug_mode=\"\");" 0' -o 'process detach' -o 'script import os; os._exit(1)'' returned non-zero exit status 1.
+					  ```
+			- #### 2 - `langgraph dev` in a [[PyCharm/Run Configuration]], then use [[PyCharm/Debug/Attach to Process]]
+				- setup - same as 1, except running `langgraph dev` using a run configuration
+				- same result as 1
+		-

pages/langgraph___CLI___dev___How To___Debug___PyCharm.md

@@ -1,5 +1,5 @@
 # How to handle langgraph's blocking error
-	- ## sample error - "LangGraph dev identified a synchronous blocking call in your code"
+	- ## sample error 1 - "LangGraph dev identified a synchronous blocking call in your code"
 		- ```
 		  Heads up! LangGraph dev identified a synchronous blocking call in your code. When running in an ASGI web server, blocking calls can degrade performance for everyone since they tie up the event loop.
 		  Here are your options to fix this:
@@ -14,6 +14,9 @@
 		  ```
 	- ## Sub-optimal workarounds
 		- For development: Run 'langgraph dev --allow-blocking'
-		- For deployment: Set 'BG_JOB_ISOLATED_LOOPS=true' environment variable
+		- For deployment: Set 'BG_JOB_ISOLATED_LOOPS=true' environment variable [[langgraph/CLI/EnvVar/BG_JOB_ISOLATED_LOOPS]]
 	- ## Better workarounds
-		- search your code for synchronous clients and replace them with async clients
+		- search your code for synchronous clients and replace them with async clients
+	- ## Resources
+		- [blockbuster causes blocking error via tiktoken in async context with latest langgraph-api · Issue #4218 · langchain-ai/langgraph](https://github.com/langchain-ai/langgraph/issues/4218)
+			- References workarounds; recommendation from