sync: update from private repo (f6d625db)

docs/tools/calendar.md

@@ -15,12 +15,13 @@ cron の定期タスク（`scheduled_tasks`）とは別概念（予定は実行
 - `title`（必須）: 予定のタイトル
 - `date`（必須）: 開始日 `YYYY-MM-DD`（ローカル日付）
 - `end_date`（任意）: 終了日 `YYYY-MM-DD`。複数日にまたがる予定のとき指定。省略すると単日。`date` より前は不可
-- `time`（任意）: `HH:MM`。省略すると終日扱い
+- `time`（任意）: 開始 `HH:MM`。省略すると終日扱い
+- `end_time`（任意）: 終了 `HH:MM`。`time`（開始）があるときだけ有効。単日では開始時刻以降のみ（複数日は終了日側の時刻なので順序不問）
 - `description`（任意）: 補足説明
 
 例:
 ```
-AddCalendarEvent({ title: "定例MTG", date: "2026-07-01", time: "10:00" })
+AddCalendarEvent({ title: "定例MTG", date: "2026-07-01", time: "10:00", end_time: "11:00" })
 AddCalendarEvent({ title: "提出締切", date: "2026-07-10" })   // 終日
 AddCalendarEvent({ title: "現地出張", date: "2026-07-10", end_date: "2026-07-12" })  // 複数日
 ```
@@ -40,6 +41,7 @@ AddCalendarEvent({ title: "現地出張", date: "2026-07-10", end_date: "2026-07
 
 ## gotcha
 
-- `date` / `from` / `to` は `YYYY-MM-DD`、`time` は `HH:MM` 厳守。形式違反はエラー。
+- `date` / `from` / `to` は `YYYY-MM-DD`、`time` / `end_time` は `HH:MM` 厳守。形式違反はエラー。
+- `end_time` は `time` なしには指定できない（終日の予定に終了時刻は持てない）。
 - スペース未所属のタスクからは呼べない（`ctx.spaceId` 必須）。
 - 予定はスペースの可視性に従う。イベント単独の可視性は持たない。