Design Doc: Hooks v2 API

support@taskwarrior.org (Taskwarrior Team)
Sun, 29 Mar 2015 20:46:43 UTC

To support an evolving Hooks API, Taskwarrior must provide hook
scripts with a mechanism for determining which version of the
Hooks API is prividing the context for the script.

It is anticipated that in future versions, new events will be
added, and changes to the interfaces will occur. A hook script
needs to act according to the API version, otherwise it risks
incompatibility with Taskwarrior.

The interfaces define what is provided as standard input, and
what is expected on standard output. With v2 there
will also be command line arguments provided to the script.