@fukuchang/taskchute-mcp 0.1.2 → 0.3.0

package/CHANGELOG.md

@@ -1,10 +1,236 @@
 # Changelog
 
-## 0.1.2 (Unreleased)
+## 0.3.0 (2026-05-28) — 実績時刻の秒精度サポート
+
+### Added
+
+- `set_actual_times` の `start_time` / `end_time` が `HH:MM` に加え `HH:MM:SS`
+  も受け入れるようになった。秒は任意で、省略時は従来通り 0 として扱う。Web UI
+  でも実績時刻の入力 / 表示が秒精度で行えるようになり、Play ボタンを押した時刻
+  も秒単位で `actual_start_time` に記録される。
+
+### Notes
+
+- 後方互換あり: 既存の `HH:MM` 入力 / 保存データはそのまま動く。Supabase の
+  時刻カラムは TEXT のためマイグレーション不要
+- `start_task` / 並列タスク / 割り込みタスクで記録される `actual_start_time`
+  は今後 `HH:MM:SS` 形式で返ることがある (従来は `HH:MM`)。文字列としての
+  扱いは変わらないが、下流ツールが正規表現で `HH:MM` のみを期待していた場合
+  は `HH:MM(:SS)?` にゆるめる必要がある
+
+## 0.2.0 (2026-05-28) — Web パリティ完全達成 ✨
+
+5 PR (PR1〜5) で MCP/CLI を Web 機能パリティまで拡張し、PR6 で SOLID 観点の
+リファクタを実施。tool 数 5 → **39**。詳細は下記の PR 単位サブセクション。
+
+### PR6 — 付け焼き刃清算 (refactor)
+
+- DRY: `tasks/add.ts` / `tasks/update.ts` の手書き prefix 解決を
+  `resolveResourceIdByPrefix` に統一
+- YAGNI: `tasks/update.ts` の `void date;` デッドコード除去
+- fail-fast: `update_routine` の auditingTask undefined fallback を削除し、
+  設定ミスは早期失敗 (`McpToolError` / `CliError`) に
+- 重複集約: 4 ファイルの error wrap パターンを `wrapDomainErrors` ヘルパー
+  (`crypto-context.ts`) に集約
+- type predicate 化: status enum の `as` キャストを `isRoutineStatus` /
+  `isTimeBlockStatus` で除去
+- test-helpers: makeMockAppContext のデフォルトで auditingTask の duck-typed
+  mock を提供
+- 機能変更ゼロ、テスト 608 件全 pass
+
+### PR5: 高度な task 操作 4 tool / Web パリティ完全達成 ✨
+
+PR1〜4 で揃えた基本 CRUD + リソース管理に加え、Web Today で可能な高度な操作
+4 種を実装。これで **Web 機能パリティを完全達成** (35 → **39 tool**)。
+
+### Added
+
+- `set_actual_times` — 実績開始/終了時刻を直接指定 (Play ボタン押し忘れ
+  リカバリ用)。Domain の `buildSetActualTimesPatch` をそのまま流用 (Web の
+  task-row-actual-times-editor と完全同期挙動):
+  - start + end → completed (sessions に 1 件)
+  - start のみ → running (currentSession セット、過去 sessions 破棄)
+  - 両方 null → planned リセット (実績全クリア)
+  - end < start → 日跨ぎセッション扱い (finishedAt を翌日繰上げ)
+  - end のみ (start なし) → McpToolError
+- `interrupt_task` — 走行中タスクへの割り込み。Domain の
+  `interruptTaskWithAudit` を使い、1 呼び出しで 3 タスクを操作 + split note
+  3 件を自動記録:
+  - finishedOriginal (元タスク completed)
+  - interruption (running 状態で新規作成 + 即計測開始)
+  - continuation (元タスクの残作業を planned で新規、splitFromTaskId 保持)
+  - 元タスクが running 中でないとエラー
+- `add_parallel_task` — 進行中タスクと**並行する**新規タスクを追加。
+  `start_immediately: true` (default) で running 状態 + 即計測開始、false で
+  planned 作成のみ。`is_background: true` 併用で見積もり集計から除外
+- `reorder_task` — 並び順 (`order_index`) と `scheduled_start_time` を直接
+  指定。Web は dnd-kit + computeReorderPatch だが、MCP/CLI は AI/人間が直接
+  数値指定する方が直感的なので patch を直接受け取る形にした (慣習 10 単位)
+
+### test-helpers 拡張
+
+- `InMemoryTaskNoteRepository` を新設 (`interrupt_task` の split note create
+  テストに必要)
+- `makeMockAppContext` の opts に `taskNoteRepo` を追加
+
+### 全 PR 達成サマリー
+
+- PR1: Task CRUD 拡張 (5 → 9 tool)
+- PR2: List 6 + audit lookups 有効化 (15 tool)
+- PR3: Project / Tag / Context CRUD 12 tool (27 tool)
+- PR4: Routine + TimeBlock CRUD 8 tool + propagation (35 tool)
+- **PR5: 高度な task 操作 4 tool (39 tool / Web パリティ完全達成 ✨)**
+
+### PR4: Routine + TimeBlock CRUD 8 tool / propagation 含む
+
+Web の Routine / TimeBlock ページの write 操作を MCP からも全部できるよう拡張。
+27 tool → **35 tool**。`update_routine` は未来 planned task への自動伝播を含み、
+PR2 で露出した `repos.auditingTask` 経由で `routine-propagation` cause を audit
+に記録する (Web `routines-page.tsx` の onUpdate ロジックを再現)。
+
+### Added
+
+- `create_routine` / `update_routine` / `archive_routine` / `delete_routine`
+  - frequency は zod の `discriminatedUnion('type', [...])` で型安全
+    (`daily` / `weekly` + weekdays / `monthly` + days / `custom` + cron)
+  - update_routine は `pickPropagationTargets` で未来 planned task を絞り込み、
+    `buildRoutineTaskPatch` で patch を構築、`auditingTask.updateWithCause(id,
+    patch, 'routine-propagation')` で伝播。`propagated_task_count` を返す
+  - 過去日 / running / completed / skipped / 別 routine_id は保護される
+  - `auditingTask` が undefined の時 (テスト等) は通常 update に fallback
+- `create_time_block` / `update_time_block` / `archive_time_block` /
+  `delete_time_block`
+  - weekdays は 0=日曜～6=土曜の配列、min(1) 強制
+  - default_project_id / default_context_id / default_tag_ids 指定可能 (ブロック
+    範囲に追加されたタスクのデフォルト値として Web 側で使われる)
+
+### Notes
+
+- update_routine description に「**未来 planned タスクの手動編集も上書きされる
+  点に注意**」を明示。Web も同じ仕様なので AI/CLI/Web 全部で挙動が揃う
+- archive vs delete 規約継承:
+  - routine archive: 既存 task の routine_id 維持 (履歴可)
+  - routine delete: routine_id は ON DELETE SET NULL で NULL 化
+  - time_block: タスクは時刻ベースで動的にブロック判定するので参照不整合なし
+
+### PR3: Project / Tag / Context CRUD 12 tool
+
+Web の Project / Tag / Context ページで可能な write 操作を MCP からも全部
+できるよう拡張。15 tool → **27 tool** に。3 リソース × 4 op
+(create / update / archive / delete) を network 越しに完結できる。
+
+### Added
+
+- `create_project` / `update_project` / `archive_project` / `delete_project`
+  - update は partial / null クリア (PR1 update_task と同じセマンティクス)
+  - parent_project_id は事前存在検証 + 自己参照禁止
+  - archive vs delete: archive はタスクの project_id 維持、delete は
+    `ON DELETE SET NULL` で NULL 化 (description に明示)
+- `create_tag` / `update_tag` / `archive_tag` / `delete_tag`
+  - delete はタスクの tag_ids 配列 (UUID[]) に**孤児 id**を残す。
+    UI 表示時に「不明なタグ」扱いになるので、履歴尊重なら archive 推奨
+    (description に明示)
+- `create_context` / `update_context` / `archive_context` / `delete_context`
+  - icon フィールドあり (絵文字またはアイコン名)
+  - delete はタスクの context_id を NULL 化
+
+### Schema 設計
+
+- archive 系 tool は `id` のみ。`active → archived` の遷移を意図する明示的 API
+- update 系 tool で `status: 'active' | 'archived'` も受け付けるが、archive 化は
+  `archive_X` tool 推奨と description で誘導 (archived → active 復元には update
+  で `status: 'active'` を使う想定)
+- partial update での null セマンティクス継承 ([[feedback_mcp_cli_parity_design]])
+
+### PR2: List 6 種 + audit 有効化
+
+Web の Today / Resource ページで参照できるリソースを MCP からも引けるよう拡張。
+9 tool → **15 tool** に。AI が `add_task` / `update_task` の `project_id` /
+`tag_ids` / `context_id` に渡す UUID を取得できるようになり、PR1 で追加した
+update_task のフル機能が初めて実用化される。
+
+### Added
+
+- `list_projects` / `list_tags` / `list_contexts` — リソース一覧。`status`
+  filter (`active` / `archived`、tag/context は同じ、project は同じ) で archived を
+  含めるか選択可能。`limit` 既定 100 で AI コンテキスト爆発を防ぐ
+- `list_routines` — ルーチン (繰り返しタスクテンプレート) 一覧。`frequency` は
+  discriminated union (`{type: 'daily'}` / `{type: 'weekly', weekdays: [...]}` /
+  `{type: 'monthly', days: [...]}` / `{type: 'custom', cron: '...'}`) のまま出力
+- `list_time_blocks` — タイムブロック (時間帯テンプレート) 一覧。`weekdays` /
+  `start_time` / `end_time` を snake_case で
+- `list_recent_tasks` — 過去 N 日 (default 90) のタスク。`query` で fuzzy match
+  (ひらがな↔カタカナ正規化込み) で類似タイトル上位を返す。指定なしは
+  `updatedAt` 降順 (最近触った順)
+- 5 つの format helper (`project-summary` / `tag-summary` / `context-summary` /
+  `routine-summary` / `time-block-summary`) を新設。`task-summary` と同じく
+  snake_case + ISO 8601 + null は出さず optional 省略
+
+### Changed
+
+- **audit lookups を有効化**。`createNodeAppContext` 内で
+  `buildRepositories(supabase, session, () => lookupsRef.current)` を呼び、初回
+  ロード + 必要に応じて `ctx.refreshLookups()` で再取得できるようにした。これに
+  より PR1 の `update_task` 等が実行された時に TaskNote へ audit ノートが
+  自動記録される (Web と非対称だった監査ログが揃う)
+- `AppContext` に `refreshLookups: () => Promise<void>` を追加。MCP server が
+  長命プロセスで動く時、新規 project/tag/context の name を audit に反映する
+  ための明示的 refresh フック
+- `buildRepositories` の戻り値型に `auditingTask?: AuditingTaskRepository` を
+  追加。`getLookups` を渡した時のみ存在し、PR4 の routine 伝播で
+  `updateWithCause('routine-propagation')` を型安全に呼べる公開口を作った。
+  Web 側 `useAuditingTaskRepository` は既存の `instanceof` 判定で動き続ける
+  (互換)
+- `test-helpers.ts` に `InMemoryRoutineRepository` / `InMemoryTimeBlockRepository`
+  + `makeRoutine` / `makeTimeBlock` を追加。`makeMockAppContext` に
+  `routineRepo` / `timeBlockRepo` opts と `refreshLookups: () => Promise.resolve()`
+  既定実装を追加
+
+### PR1: Task CRUD パリティ
+
+Web の Today で当たり前にできる task 操作を MCP からも全部できるよう拡張。
+5 tool → **9 tool** に。
+
+### Added
+
+- `update_task` — タスクのユーザー編集可能フィールドを部分更新する
+  (`title` / `description` / `estimated_seconds` / `scheduled_start_time` /
+  `project_id` / `context_id` / `tag_ids` / `notify_at_scheduled_start` /
+  `is_background`)。`undefined` は変更なし、`null` は明示クリア。`tag_ids` は
+  全置換。`status` / `order_index` / `actual_start_time` / `routine_id` 等の
+  システムフィールドは update では触れない (専用 tool 経由のみ)。
+- `delete_task` — タスクを削除する。既定は `deleteWithRoutineSkip` で Routine
+  由来タスクを今日以降に消した時 `routine_expansions` に skip 記録を残す。
+  `hard_delete: true` で物理削除のみ (上級者向け)。
+- `skip_task` — タスクを skipped に遷移させる。running 中なら currentSession を
+  sessions に取り込む。
+- `reopen_task` — completed / skipped を planned に戻す。planned/running/paused
+  は no-op。
+
+### Changed
+
+- `add_task` の入力に `project_id` / `context_id` / `tag_ids` /
+  `scheduled_start_time` / `notify_at_scheduled_start` / `is_background` を追加
+  (全 optional)。これにより MCP からも Web の Today add 同等のタスク追加が可能
+  になった。
+- `add_task` / `update_task` は `project_id` / `context_id` / `tag_ids` を受け
+  取った時、RLS より前に `findById` で存在検証してから AI に分かりやすい
+  `McpToolError` を返す。
+- `test-helpers.ts` に `InMemoryProjectRepository` / `InMemoryTagRepository` /
+  `InMemoryContextRepository` を追加。`makeMockAppContext` に
+  `projectRepo` / `tagRepo` / `contextRepo` を渡せる opts を追加。
+
+## 0.1.2 (2026-05-24)
 
 CLI (`@fukuchang/taskchute-cli`) と歩調を揃えるため、初回リリースのバージョン
 を 0.1.0 ではなく 0.1.2 から開始する。以降は SemVer に従って独立に bump する。
 
+初回 publish は Bypass 2FA Granular Access Token で bootstrap publish した後、
+即 token revoke + Trusted Publisher (GitHub Actions OIDC / `publish-mcp.yml`)
+登録 + `Publishing access: Require 2FA and disallow tokens` 設定に切り替え。
+以降の release は `mcp-v*` tag push で `.github/workflows/publish-mcp.yml` が
+OIDC publish する経路に固定される。
+
 - Initial release. 5 tools 公開:
   - `list_tasks(date?)` — 指定日 (省略時は今日) のタスク一覧を返す
   - `add_task(title, date?, estimated_seconds?, description?)` — タスク追加

package/README.md

@@ -3,24 +3,60 @@
 TaskChute MCP server — [Model Context Protocol](https://modelcontextprotocol.io/) 経由で
 E2EE 暗号化された TaskChute タスクを Claude Desktop / Claude Code 等から操作するためのサーバー。
 
-> **Status:** 0.1.2 (initial release, PR 13). 提供 tool は `list_tasks` / `add_task` /
-> `start_task` / `pause_task` / `done_task` の 5 つ。npm 公開は PR 14 で実施予定。
-> 初回バージョンを 0.1.2 から始めるのは、CLI (`@fukuchang/taskchute-cli`) と
-> 歩調を揃えるため (以降は独立 SemVer)。
+> **Status: Web パリティ完全達成 ✨** (PR1〜5 / 39 tool)。Web の Today /
+> Resource / Routine / TimeBlock 操作 + 割り込み / 並列タスク / 実績時刻直接
+> 指定 / D&D reorder まで全機能を AI から操作できる。Routine update は未来
+> planned task への自動伝播、interrupt は split note 自動記録、audit lookups
+> も有効。初回バージョン (0.1.2) は CLI と歩調を揃えるためのもので、以降は
+> 独立 SemVer。
+
+## インストール
+
+```bash
+npm i -g @fukuchang/taskchute-mcp
+```
+
+`taskchute-mcp` コマンドが PATH に通る。MCP client (Claude Desktop / Claude Code 等)
+の設定から `command: "taskchute-mcp"` で起動できる。
 
 ## 提供 tool
 
 | tool | 説明 |
 | --- | --- |
 | `list_tasks` | 指定日 (省略時は今日) のタスク一覧を返す |
-| `add_task` | タスクを追加する (title, date?, estimated_seconds?, description?) |
+| `add_task` | タスクを追加する (title, date?, estimated_seconds?, description?, project_id?, context_id?, tag_ids?, scheduled_start_time?, notify_at_scheduled_start?, is_background?) |
+| `update_task` | タスクのフィールドを部分更新する (タイトル / 詳細 / 見積もり / 予定時刻 / project / context / tags / 通知 / バックグラウンドフラグ)。`null` で明示クリア、`tag_ids` は全置換 |
+| `delete_task` | タスクを削除する (Routine 由来タスクを今日以降に消すと `routine_expansions` に skip 記録、`hard_delete: true` で物理削除のみ) |
 | `start_task` | タスクの計測を開始する (status → running) |
 | `pause_task` | タスクを一時停止する (status → paused) |
 | `done_task` | タスクを完了する (status → completed) |
-
-入力 `id` は full UUID。`list_tasks` の結果から取って `start_task` / `pause_task` /
-`done_task` に渡す想定。`estimated_seconds` は秒数の整数 (CLI と違って文字列パースは
-しない)。
+| `skip_task` | タスクをスキップする (status → skipped)。reopen で planned に戻せる |
+| `reopen_task` | completed / skipped を planned に戻す |
+| `list_projects` | プロジェクト一覧 (status filter / limit 既定 100)。add/update_task の `project_id` を引くために使う |
+| `list_tags` | タグ一覧。`tag_ids` を引くために使う |
+| `list_contexts` | コンテキスト一覧。`context_id` を引くために使う |
+| `list_routines` | ルーチン (繰り返しタスクテンプレート) 一覧。`frequency` は discriminated union (`{type: 'daily'}` / `{type: 'weekly', weekdays: [...]}` 等) のまま |
+| `list_time_blocks` | タイムブロック (時間帯テンプレート) 一覧 |
+| `list_recent_tasks` | 過去 N 日 (既定 90) のタスク。`query` で fuzzy match (ひらがな↔カタカナ正規化込み) 検索可能 |
+| `create_project` / `update_project` / `archive_project` / `delete_project` | プロジェクト CRUD。`update` は partial / null クリア。`archive` はタスクの project_id を維持、`delete` は NULL 化 (ON DELETE SET NULL) |
+| `create_tag` / `update_tag` / `archive_tag` / `delete_tag` | タグ CRUD。`delete` は tag_ids 配列に孤児 id を残すので注意 (UI 表示時に「不明なタグ」扱い) |
+| `create_context` / `update_context` / `archive_context` / `delete_context` | コンテキスト CRUD。`delete` はタスクの context_id を NULL 化 |
+| `create_routine` / `update_routine` / `archive_routine` / `delete_routine` | ルーチン CRUD。`update_routine` は **未来 planned task に自動伝播** (title / estimated / project / context / tags / scheduled_start_time)。手動編集も上書きされる点に注意。`propagated_task_count` を返す |
+| `create_time_block` / `update_time_block` / `archive_time_block` / `delete_time_block` | タイムブロック CRUD。`weekdays` は 0=日曜～6=土曜の配列 (空不可) |
+| `set_actual_times` | 実績開始/終了時刻を直接指定 (Play 押し忘れリカバリ用)。start+end → completed、start のみ → running、両方 null → planned リセット、end < start → 日跨ぎセッション |
+| `interrupt_task` | 走行中タスクを「割り込み」で分割。1 呼び出しで 3 タスクを生成 (元タスク完了 / 割り込み running / 残作業 planned) + split note 3 件自動記録 |
+| `add_parallel_task` | 進行中タスクと並行する新規タスクを追加。既定で running 状態 + 即計測開始 |
+| `reorder_task` | 並び順 (order_index) と所属タイムブロックを直接指定 (慣習 10 単位) |
+
+入力 `id` は full UUID。`list_tasks` の結果から取って各 tool に渡す想定。
+`estimated_seconds` は秒数の整数 (CLI と違って文字列パースはしない)。
+
+**部分更新セマンティクス**: `update_task` の各フィールドは「未指定 (`undefined`) =
+変更なし、`null` = 明示クリア」を区別する。`title` / `estimated_seconds` /
+`notify_at_scheduled_start` / `is_background` / `tag_ids` は `null` を受け取らない
+(常に値を渡す or 省略)。`status` / `order_index` / `actual_start_time` /
+`current_session` / `sessions` / `routine_id` / `split_from_task_id` 等の
+システムフィールドは update では触れない (専用 tool 経由のみ)。
 
 ## 認証 / E2EE