docs(logger): improve documentation of whitespace handling

lib/logger/src/format.ts

@@ -21,9 +21,12 @@ export const createFormatter = (thisLogger: winston.Logger) =>
       }
       if (info.process) {
         labels += `[${styles.dim(info.process)}]`
-      } else {
+      }
+
+      if (!info.process) {
         // simulate the newline present in a normal console.log (which we've
-        // removed from the Console transport)
+        // removed from the Console transport to support logging forked
+        // processes which don't necessarilly flush on a newline)
         message += '\n'
       }
 

lib/logger/src/helpers.ts

@@ -115,7 +115,9 @@ export function hookFork(
           readableObjectMode: true,
           transform: (message, _enc, callback) => {
             // add the log level and wrap the message for the winston stream to
-            // consume
+            // consume. we preserve newlines here as, unlike other cases, this
+            // logger can be called in the middle of a line depending on when
+            // the stream is flushed.
             callback(null, { level, message: stripAnsiReset(message) })
           }
         })