calendar: fix _days_until to handle Unix timestamps from todoman --porcelain

skills/calendar/TESTING.md

@@ -170,22 +170,26 @@ $SKILL_DIR/scripts/calendar.sh todo add \
 **Verify:**
 - [ ] Script exits without error
 - [ ] `.ics` file created in `~/.openclaw/workspace/calendars/tasks/`
+- [ ] `todo list` (todoman directly) shows "Test Todo"
 - [ ] Email arrives at `mail@luyx.org` with .ics attachment
 - [ ] `vdirsyncer sync` ran
 
 ## 9. List Todos
 
 ```bash
-# List pending todos
+# Via our wrapper (formatted Chinese output)
 $SKILL_DIR/scripts/calendar.sh todo list
 
-# List all (including completed)
+# Via todoman directly (should show the same items)
+todo list
+
+# Include completed
 $SKILL_DIR/scripts/calendar.sh todo list --all
 ```
 
 **Verify:**
-- [ ] "Test Todo" appears with correct urgency label
+- [ ] "Test Todo" appears in both outputs
-- [ ] Priority grouping is correct
+- [ ] Priority grouping is correct in wrapper output
 - [ ] `--all` flag works (same output when none are completed)
 
 ## 10. Complete a Todo
@@ -195,9 +199,9 @@ $SKILL_DIR/scripts/calendar.sh todo complete --match "Test Todo"
 ```
 
 **Verify:**
-- [ ] .ics file updated with `STATUS:COMPLETED` and `COMPLETED:` timestamp
+- [ ] `todo list` (todoman) — "Test Todo" no longer appears
-- [ ] `todo list` — "Test Todo" no longer appears
+- [ ] `$SKILL_DIR/scripts/calendar.sh todo list` — also gone
-- [ ] `todo list --all` — "Test Todo" appears as completed (with checkmark)
+- [ ] `$SKILL_DIR/scripts/calendar.sh todo list --all` — appears as completed (with checkmark)
 - [ ] `vdirsyncer sync` ran
 
 ## 11. Delete a Todo
@@ -211,13 +215,16 @@ $SKILL_DIR/scripts/calendar.sh todo add \
   --due "$TEST_DATE" \
   --priority low
 
+# Confirm it appears
+todo list
+
 # Delete
 $SKILL_DIR/scripts/calendar.sh todo delete --match "Delete Me"
 ```
 
 **Verify:**
 - [ ] .ics file removed from tasks dir
-- [ ] `todo list` does not show "Delete Me Todo"
+- [ ] `todo list` (todoman) does not show "Delete Me Todo"
 - [ ] `vdirsyncer sync` ran
 
 ## 12. Todo Check (Cron Output)
@@ -278,6 +285,9 @@ vdirsyncer sync
 
 # khal can read local calendar
 khal list today 7d
+
+# todoman can list todos
+todo list
 ```
 
 ## Common Failures
@@ -290,4 +300,6 @@ khal list today 7d
 | `ModuleNotFoundError: icalendar` | Run `uv sync --project $SKILL_DIR` to install dependencies |
 | Invite shows as attachment (no Accept/Decline) | Check MIME `Content-Type` includes `method=REQUEST` |
 | Event not in `khal list` after sync | Check `.ics` file exists in `~/.openclaw/workspace/calendars/home/` |
+| `todo` command not found | Install with `uv tool install todoman` |
+| `todo list` errors | Check `~/.config/todoman/config.py` exists and `path` points to tasks dir |
 | Todo not syncing | Check `~/.openclaw/workspace/calendars/tasks/` exists, verify vdirsyncer `cal/tasks` pair |

skills/calendar/scripts/cal_tool.py

@@ -413,15 +413,23 @@ def _todoman_list_json(*extra_args):
     return json.loads(result.stdout)
 
 
-def _days_until(due_str):
+def _days_until(due_val):
-    """Days from today until due date string. Negative means overdue."""
+    """Days from today until due date (string or Unix timestamp). Negative means overdue."""
-    if not due_str:
+    if not due_val:
         return None
+    # Unix timestamp (int/float) from todoman --porcelain
+    if isinstance(due_val, (int, float)):
+        try:
+            due_date = datetime.fromtimestamp(due_val, tz=timezone.utc).date()
+        except (ValueError, TypeError, OSError):
+            return None
+        return (due_date - date.today()).days
+    # String formats (ISO or YYYY-MM-DD)
     try:
-        due_date = datetime.fromisoformat(due_str).date()
+        due_date = datetime.fromisoformat(due_val).date()
     except (ValueError, TypeError):
         try:
-            due_date = _parse_date(due_str)
+            due_date = _parse_date(due_val)
         except ValueError:
             return None
     return (due_date - date.today()).days