Vision regarding the JSON interface

Hello,

It's rather discussion than an issue.

A few weeks ago I noticed that Khal has got the option --json. Being excited about that feature I created a little application which shows the events of the current week. Given that, I named it Semana, which means "week" from Spanish. https://github.com/laladrik/Semana

As of now, Semana is unable to create, edit or delete events. Khal allows a user to do those things via the interactive mode (khal interactive). This is not an interesting option when you implement a client application. Apart from the interactive mode Khal provides the commands "edit" and "new". The command "edit" allows an event to be edited or deleted. This is good from a user perspective, but difficult for from a machine perspective.

The main reason is that the event, which is be edited, is determined by the search among event titles. This might be ambiguous if a user has two events with the same title. Let's imagine, the first event is on Monday, the second event is on Friday. It doesn't matter whether those events reoccur or not. Given that, the command "edit" shows both of them to the user. If there is another option to edit an event, please let me know, I might've overlooked it.

Before improving Khal to allow Semana to support the operations I have a question. Do you have any vision regarding the feature of JSON? I will align the improvement with the vision.

Review Khal's existing --json option and the edit and new commands described in the issue, then trace how events are selected by title. Done means an agreed JSON interface vision is documented, including the scope and behavior needed for unambiguous event operations.