Org API

Build a graph for the given habit, from starting to ending. current gives the current time between starting and ending, for the purpose of drawing the graph. It need not be the actual current time.

Return faces for habit relative to now-days and scheduled-days. now-days defaults to the current time's days-past-the-epoch if nil. scheduled-days defaults to the habit's actual scheduled days if nil.

Habits are assigned colors on the following basis:

Blue      Task is before the scheduled date.
Green     Task is on or after scheduled date, but before the

end of the schedule's repeat period.

Yellow    If the task has a deadline, then it is after schedule's

repeat period, but before the deadline.

Orange    The task has reached the deadline day, or if there is

no deadline, the end of the schedule's repeat period.

Red       The task has gone beyond the deadline day or the

schedule's repeat period.

Determine the relative priority of a habit. This must take into account not just urgency, but consistency as well.

Insert consistency graph for any habitual tasks.

Parse the TODO surrounding point for its habit-related data. Returns a list with the following elements:

0: Scheduled date for the habit (may be in the past)
1: ".+"-style repeater for the schedule, in days
2: Optional deadline (nil if not present)
3: If deadline, the repeater for the deadline, otherwise nil
4: A list of all the past dates this todo was mark closed

This list represents a "habit" for the rest of this module.

Toggle display of habits in an agenda buffer.