Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming. Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
9.3 KiB
タスクの所属統一とCalDAV上書き同期
後続0.11.1:既定タスクリストの表示名変更を実装し、2026-09-27 12:51 JSTに本番反映。所属・URLは維持したまま、固定名PagesWiki Tasksを利用者ごとに変更できる。
2026-09-27。organizer.tasks 0.11.0。12:18 JSTに本番app/app2へ反映済み。Tasks.org Desktop実機の再同期は利用者確認待ち。 反映・移行確認記録。
利用者の決定:PagesWikiのプロジェクトと外部タスクリストを統一する。条件なしの書き込みは上書きを受け付け、トークン単位の上書き互換スイッチは設けない。競合を通知してどちらを採用するか選ぶ機能は次段階に実装する。
1. 確認した不整合
0.10.0では、MKCALENDARで作ったリストのみプロジェクトと一対一に対応し、通常のWebプロジェクトはプロジェクトなしのタスクと同じ既定リストに混在していた。また、既存リソースのPUT/DELETEは条件ヘッダ必須で、直接接続クライアントの無条件更新を428で拒否していた。
Tasks.org公開ソースの確認対象はcommit 0fde622e917ea2cbb0956c3effe9209c11045a67。CaldavSynchronizer.pushTaskはremote.put(requestBody)、削除はremote.delete {}で条件ヘッダを渡さない。依存するdav4kmp 1.0.0-beta01(commit dec7bd10952278c7ac196de111880f00d75d8f3e)もそれを自動補完しない。本番の秘匿ログに認証成功後のPUT 428が反復していた。ただし、利用者のインストール版と調査したソースが同じか、個々のログがDesktop由来かは未確定。ctag追加による解決ではない。
2. 所属・URI契約
| 正本の所属 | CalDAVリスト |
|---|---|
ProjectUUIDが空 |
/_/api/v1/caldav/tasks/default/。既存表示名PagesWiki Tasksは維持し、意味をプロジェクトなしに限定 |
| 通常のWebプロジェクト | /_/api/v1/caldav/tasks/projects/{projectUUID}/ |
| 既存MKCALENDARプロジェクト | /_/api/v1/caldav/{dav_collection}/。既存URLを維持 |
- タスクのUUID、UID、filename、ProjectUUID、版、本文を移行で変更しない。名前やカテゴリから所属を推測しない。
- 通常プロジェクトのURLは不変UUIDから導出するため、
dav_collectionを正本へ後付けする必要はない。表示名は常にプロジェクトのタイトル。名称変更でURLは変わらない。 tasks/projects/はタスク専用名前空間。予定カレンダーのUUIDと衝突しない。外部取り込み予定は読まない。- リストの新規タスクはそのプロジェクトへ所属する。Webで所属を変更するとリスト間を移る。CalDAVのMOVE実装とは別。
- 閲覧できるのは同じdomain/ownerのプロジェクトのみ。アーカイブ済みプロジェクトは探索・アクセスから除外し、そのタスクを既定リストへ流出させない。
- リスト全体の完全な探索に現在の256件上限を適用し、超過時に部分リストを返さず507にする。将来の大量プロジェクト向け探索最適化は残件。
3. 移行と古いクライアント
起動時のEnsureTasksSchemaで、ルーティング索引とタスクのリスト別identity索引を同じDB transactionで再構築する。全プロジェクト(アーカイブ済みも含む)とタスクの現行headから導出し、失敗時は全体をrollbackする。正本・履歴を書き換えず、反復実行でURI/ETagは変わらない。起動時の再構築はタスク数に比例する処理であり、リクエストごとには行わない。
既定リストから通常プロジェクトへ移った旧hrefはorganizer_dav_legacy_hrefsに移行メタデータとして記録する。旧hrefへのGETは404、古い未同期PUTによる再作成は409 task_collection_relocated。別リストを旧href経由で変更・削除するaliasにはしない。これにより、古い端末の再送で同じタスクがプロジェクトなしに増えることを防ぐ。索引を再構築しても移行メタデータは保持する。
本番反映前後には未送信の変更を保全し、各端末でリストの再探索・新しいプロジェクトの同期有効化を行う。未同期データがある状態でアカウントやローカルデータを削除しない。409の場合は新しい所属リストを確認して未送信変更を反映する。0.10以下へ安易に戻すと旧既定リストに再混在するため、戻す場合はタスク拡張を停止し移行方針を確認する。
4. 書き込みの現行契約
- 条件ヘッダなしのPUT/DELETEを全タスクCalDAV接続で受理する。追加のトークン互換設定・User-Agent判定は設けない。既存のOPTIONS calendar-access広告設定とは独立した話。
- 最後にcommitした内容を採用する。削除は従来どおりアーカイブ。削除後に無条件PUTが来た場合は同じidentityの新しい版として復元する。
- 明示されたIf-Match/If-None-MatchはHTTPの事前条件として尊重し、不成立なら412。Web UI/JSON APIの版チェックは変更しない。
- 保存は既存のwriter transactionとversion CASを維持する。条件なし書込の競合時は最新headを取得して最大8回再試行し、CalDAVで表現する項目だけを再適用する。PagesWiki固有の計画日・整理先・関連文書等を古いheadへ巻き戻さない。過度な競合は409で再同期を要求する。
- 同時新規作成は同じhrefの1identityへ収束する。別hrefへのUID衝突、UID変更、他利用者へのアクセス、失効トークン、readonly、無効化された拡張は従来どおり拒否。
- 新規head、CAS本文、organizer_revisions、organizer_changesは既存の同一保存処理を用いる。上書き前の版は保持される。PUT本文を正規化するためPUT成功応答にETagは付けず、GET/REPORTで取得する。
- この段階では競合通知も採否選択UIもない。 古い端末の変更が新しい内容を上書きし得ることは、今回採用した動作。
5. 次段階:競合通知と採否選択(未実装TODO)
- 比較の根拠と来歴:書き込み元(Web/DAV、資格情報の非秘密ID)、対象task/domain/owner、受信時刻、base版が分かるか、上書き前/採用後の版を記録する。秘密値や生の本文をアクセスログへ出さない。DTSTAMPや端末時計だけで新旧を決めない。
- baseが不明な更新:条件なし要求だけでは競合を厳密に判定できない。直近配信版などの補助記録は参照先を共有する端末もあり確定根拠にならないため、「競合候補」として扱う。全ての通常編集を競合扱いしない検出条件と上限・保持期間を設計する。
- 候補保存とInbox outbox:上書き前/受信版の参照をhead更新と同じtransactionで保存し、ownerの通知Inboxへ重複抑制付きで配送する。通常のアクティブ通知設定に従い、作業を強制的に遮らない。未解決候補が参照する版をGCしない。
- 比較・選択UI:「上書き前を採用」「受信版を採用」「現在の内容を維持」を項目差分付きで表示。採用は履歴を戻すのではなく新しいrevisionを作成する。
- 解決の競合:候補の解決時にも最新headを再確認し、通知後の第三の変更を黙って消さない。owner/domain/現在権限を再検証し、解決済み通知の二重操作を防止する。
- 受け入れ試験:Webと二つのDAV端末の競合、更新対削除、復元、通信再送、遅延したInbox配送、別domain/owner、権限失効、履歴GC、同一候補の二重決裁。
6. 今回の検証範囲
合成データで通常プロジェクトの探索・所属、旧索引移行・再実行、URI/ETag維持、古いhref再作成防止、名前変更、他owner隔離、アーカイブの非流出、無条件同時更新・同時作成・削除・復元・履歴保持を検証する。既存の明示ETag競合試験、認可試験、共通CalDAV・CLI同期・Web回帰も継続する。外部取り込みカレンダーや本番の認証情報・本文をテストデータにしない。
実施結果:go test ./...成功。追加の所属・上書き試験は10回反復成功、関連試験の-raceも成功。実chroncalで既定・共通home・MKCALENDAR・通常Webプロジェクトの各リストを検証し、vdirsyncer/Todomanも成功。ChromiumでタスクUI(desktop/laptop/mobile/mobile-small)とカレンダーUIの回帰試験成功。これらは隔離fixtureの結果であり、Tasks.org Desktopの実機成功や本番反映を意味しない。