Hooks

- Cleaned up せxample hooks, with clearer inline documentation.

scripts/hooks/on-exit

@@ -1,22 +1,19 @@
 #!/bin/bash
 
-# Input:
-# - None
+# The on-exit event is triggered once, after all processing is complete
 
-# Processing goes here.
+# Input:
+# - A read-only line of JSON for each task added/modified
+
+# Processing goes here
 
 # Output:
-# - Any line of JSON emitted is added as a new task.
-# - Any non-JSON emitted is displayed as a message.
+# - all emitted JSON lines must be fully-formed tasks
+# - all emitted non-JSON lines are considered feedback messages
 echo on-exit
 
 # Exit:
-# - 0 Means accept $new_task if JSON is not emitted.
-# - 0 Means accept all JSON as new tasks. If UUID matches $new_task, use this
-#     JSON instead of $new_task. If UUID does not match $new_task, then these
-#     are additional tasks.
-# - 0 Means all non-JSON becomes footnote entries.
-# - 1 Means all non-JSON becomes error entries.
-# - 1 Means reject $new_task.
+#   0 Means: - all emitted non-JSON lines become footnote entries
+#   1 Means: - all emitted non-JSON lines become error entries
 exit 0