docs

session_logger.py

@@ -1,4 +1,15 @@
-# session_logger.py
+# session_logger.py
+"""
+Note(Gemini):
+Opens timestamped log/script files at startup and keeps them open for the
+lifetime of the process.
+
+File layout:
+logs/comms_<ts>.log      - every comms entry (direction/kind/payload) as JSON-L
+logs/toolcalls_<ts>.log  - sequential record of every tool invocation
+scripts/generated/<ts>_<seq:04d>.ps1  - each PowerShell script the AI generated
+"""
+# session_logger.py
 """
 Opens timestamped log/script files at startup and keeps them open for the
 lifetime of the process.  The next run of the GUI creates new files; the