docs: add explanation of task runner

mostly to trigger a release workflow, also to test some gpt prompts

Sources/hyper-focus/configuration_loader.swift

@@ -25,4 +25,4 @@ enum ConfigurationLoader {
 
  return config
  }
-}
+}

Sources/hyper-focus/server.swift

@@ -43,12 +43,11 @@ class ApiServer {
  scheduledUntil = Int(nowWithStartAndEnd.timeIntervalSince1970)
  }
 
-
  return [
  "schedule": [
  "name": self.scheduleManager.plannedSchedule?.name,
  "until": scheduledUntil,
- ] as [String : Any?],
+ ] as [String: Any?],
  "override": [
  "until": self.scheduleManager.endOverride?.timeIntervalSince1970,
  "name": self.scheduleManager.overrideSchedule?.name,
@@ -69,7 +68,7 @@ class ApiServer {
  router["/schedules"] = JSONResponse { _ -> Any in
  let rawSchedules = self.scheduleManager.schedules()
 
- // TODO there's got to be a better way to convert a codable object to JSON
+ // TODO: there's got to be a better way to convert a codable object to JSON
  let schedules: [[String: Any]] = rawSchedules.map { schedule in
  let jsonData = try! JSONEncoder().encode(schedule)
  let json = try! JSONSerialization.jsonObject(with: jsonData) as! [String: Any]
@@ -79,7 +78,6 @@ class ApiServer {
  return schedules
  }
 
-
  // http -vvv POST http://localhost:8080/override name='hyper focus' until=1667514400
  router["/override"] = JSONResponse { environ -> Any in
  log("/override")

Sources/hyper-focus/taskrunner.swift

@@ -1,6 +1,11 @@
 import Cocoa
 import Foundation
 
+/**
+ This module runs shell commands. It ensures single-instance execution per task name and handles script execution timeouts.
+ Output is prefixed with task-specific identifier for easier identification in the logs.
+ */
+
 enum TaskRunner {
  static var executionLocks: [String: Bool] = [:]