1 files changed, 44 insertions, 0 deletions
diff --git a/pim/doc/todo.md b/pim/doc/todo.md
new file mode 100644
index 0000000..1e34157
--- /dev/null
+++ b/pim/doc/todo.md
@@ -0,0 +1,44 @@
+# ical/fs todo
+
+## Next
+
+- **rsvp**. `partstat` is not yet in the tree. It should be writable, and
+  the write should be the whole user interface: `echo ACCEPTED
+  >/mnt/pim/events/uuid/<uid>/partstat`. Transport stays inside the server --
+  iMIP mail via `upas/marshal` for the ics backend, a JMAP method call
+  for `jmap/fs`. `pim/rsvp` writes the file and knows nothing else.
+- **plumb port for alarms**, following `seemail`. The blocking `alarm`
+  file is one-to-one; a plumb port gives fan-out so `pim/alertcat`, a
+  bell and a logger can all see the same alarm.
+- **`pim/next`** -- print the next event, one line, for a window label.
+- **the slug is lossy**. `Go Home LTD & Kissinger -> API` becomes
+  `Go-Home-LTD-_-Kissinger--_-API`; every non-alphanumeric collapses to
+  `_`, so names are ugly and not reversible. The summary is intact inside
+  the file, but the filename could be kinder.
+- **`pim/free`** -- free/busy over a range.
+- **plumb rules** -- click a date, `agenda` opens that day.
+
+## Backends
+
+- `jmap/fs` against Fastmail. JSCalendar is JSON, so no parser; the work
+  is OAuth2 and the method surface. No Go library implements JMAP
+  calendars -- `rockorager/go-jmap` is core+mail only.
+- `caldav/fs` via `emersion/go-webdav`. Untested on plan9, but its
+  transport is `net/http`, which is verified working.
+
+## Known gaps
+
+- Absolute VALARM triggers (`TRIGGER;VALUE=DATE-TIME`) are ignored; only
+  relative ones fire. `RELATED=END`, `DURATION`+`REPEAT` unhandled.
+  Note Google's `basic.ics` exports **no VALARM at all**, so alarms need a
+  backend that carries them.
+- Embedded `VTIMEZONE` definitions are ignored. `TZID=` is resolved by
+  IANA name through Go's `time/tzdata` instead, which is correct for
+  Google (`America/New_York`) but will fail on a server that emits
+  Windows-style zone names or a zone not in the IANA database.
+- Only `STATUS:CANCELLED` cancels an occurrence. `METHOD:CANCEL` is not
+  handled.
+- The whole tree is rebuilt on refresh. Fine at this size, not forever.
+- Directory listing order from go9p is non-deterministic (it iterates a
+  map to build the child list). `ls` sorts, so it does not show, but do
+  not depend on order.