@fukuchang/taskchute-cli 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,184 @@
 
 このパッケージの変更履歴。[Keep a Changelog](https://keepachangelog.com/) 準拠。
 
+## [0.2.0] - 2026-05-28 — Web パリティ完全達成 ✨
+
+5 PR (PR1〜5) で MCP/CLI を Web 機能パリティまで拡張し、PR6 で SOLID 観点の
+リファクタを実施。タスク操作系 5 command → 17 commands、トップレベル group
+1 → 6 個に拡張。詳細は下記の PR 単位サブセクション。
+
+### PR6 — 付け焼き刃清算 (refactor)
+
+- DRY: `tasks/add.ts` / `tasks/update.ts` の手書き prefix 解決を
+  `resolveResourceIdByPrefix` に統一 (合計 -59 行)
+- YAGNI: `tasks/update.ts` の `void date;` デッドコード除去
+- fail-fast: `update_routine` の auditingTask undefined fallback を削除し、
+  設定ミスは早期失敗に
+- 重複集約: 4 ファイルの error wrap パターンを `wrapDomainErrors` ヘルパー
+  (`crypto-context.ts`) に集約
+- type predicate 化: `routines/update.ts` / `time-blocks/update.ts` の
+  status enum `as` キャストを `isRoutineStatus` / `isTimeBlockStatus` で除去
+- 機能変更ゼロ、テスト 608 件全 pass
+
+### PR5: 高度な task 操作 4 command / Web パリティ完全達成 ✨
+
+PR1〜4 で揃えた基本 CRUD + リソース管理に加え、Web Today で可能な高度な操作
+4 種を実装。これで **Web 機能パリティを完全達成**。
+
+### Added
+
+- `taskchute tasks set-actual-times <id-prefix>` — 実績開始/終了時刻を直接
+  指定 (Play 押し忘れリカバリ)。`--start HH:MM --end HH:MM` で completed、
+  `--start` のみで running、`--reset` で planned リセット。`--clear-end` の
+  みでも (start は維持) 対応。end < start は日跨ぎセッション扱い
+- `taskchute tasks interrupt <target-id-prefix> <title> --estimated <dur>` —
+  走行中タスクへの割り込み。Domain `interruptTaskWithAudit` で 3 タスクを
+  1 操作生成 + split note 3 件自動記録
+- `taskchute tasks parallel <title> --estimated <dur> [...]` — 並列タスク
+  追加。既定で即計測開始 (running)、`--no-start-immediately` で planned 作成
+  のみ。`--background` でバックグラウンドタスク化
+- `taskchute tasks reorder <id-prefix> --order-index <n> [...]` — 並び順を
+  直接指定 (慣習 10 単位)。`--scheduled HH:MM` 同時指定で別タイムブロック
+  へ移動、`--clear-scheduled` で未割当グループへ
+
+### 全 PR 達成サマリー
+
+- PR1: Task CRUD 拡張 (4 → 9 command)
+- PR2: List 5 group + tasks recent + audit lookups 有効化
+- PR3: Project / Tag / Context CRUD 12 command
+- PR4: Routine + TimeBlock CRUD 8 command + propagation
+- **PR5: 高度な task 操作 4 command / Web パリティ完全達成 ✨**
+
+### PR4: Routine + TimeBlock CRUD 8 command / propagation 含む
+
+Web の Routine / TimeBlock ページの write 操作を CLI から完結できるよう拡張。
+2 リソース × 4 op を追加 (各 group の list と合わせ 5 op に)。
+
+### Added
+
+- `taskchute routines create <title> --estimated <dur> --frequency <spec> [...]`
+  — ルーチン新規作成。`--frequency` の短縮表記は parse-frequency.ts で解釈
+  (`daily` / `weekly:1,3,5` / `monthly:1,15` / `custom:CRON_STRING`)
+- `taskchute routines update <id-prefix> [...]` — 部分更新。**未来 planned
+  task に自動伝播**。`auditingTask` 経由で `routine-propagation` cause を
+  audit に記録 (CLI でも Web と同じ挙動)。`propagated to N future task(s)`
+  を結果メッセージに含める
+- `taskchute routines archive <id-prefix>` — アーカイブ (既存 task の
+  routine_id 維持)
+- `taskchute routines delete <id-prefix>` (alias `rm`) — 物理削除 (task の
+  routine_id は NULL 化)
+- `taskchute time-blocks create <name> --start-time HH:MM --end-time HH:MM
+  --weekdays 1,2,3,4,5 [...]` — タイムブロック新規作成
+- `taskchute time-blocks update / archive / delete (rm)` (同パターン)
+- `src/format/parse-frequency.ts` を新設。`parseFrequencySpec` で `--frequency`
+  の短縮表記を domain の discriminated union に変換。`parseWeekdaysList` で
+  `--weekdays 1,2,3` を `number[]` に変換 (0-6 範囲チェック込み)
+
+### Changed
+
+- `src/resolve-resource-id.ts` の `NamedResource` を `LabeledResource` に
+  汎化 (`{id, name}` または `{id, title}`)。Routine は title 持ち、その他は
+  name 持ちなので、duck-typing で受け取り曖昧時表示用ラベルを存在する方から拾う
+
+### PR3: Project / Tag / Context CRUD 12 command
+
+Web の Project / Tag / Context ページの write 操作を CLI から完結できるよう拡張。
+3 リソース × 4 op (create / update / archive / delete) を追加。
+
+### Added
+
+- `taskchute projects create <name>` — プロジェクト新規作成 (`--description` /
+  `--color` / `--parent <prefix>` / `--started-at YYYY-MM-DD` /
+  `--target-end YYYY-MM-DD`)
+- `taskchute projects update <id-prefix>` — 部分更新。`--clear-*` で明示クリア。
+  自己参照は `A project cannot be its own parent.` エラー
+- `taskchute projects archive <id-prefix>` — アーカイブ (タスクの project_id 維持)
+- `taskchute projects delete <id-prefix>` (alias `rm`) — 物理削除 (タスクの
+  project_id は `ON DELETE SET NULL` で自動 NULL 化、子プロジェクトの
+  parent_project_id も NULL 化)
+- `taskchute tags create / update / archive / delete` (同パターン)
+- `taskchute contexts create / update / archive / delete` (icon フィールドあり)
+- `src/resolve-resource-id.ts` を新設。`resolveTaskIdByPrefix` と同じ趣旨の
+  リソース汎用 prefix 解決ヘルパー。MIN_PREFIX_LENGTH=4 統一、曖昧プレフィックス時
+  は候補一覧を `id name` で表示
+
+### Notes
+
+- tag delete はタスクの `tag_ids` 配列 (UUID[]) に**孤児 id**を残す。UI 表示時
+  に「不明なタグ」扱いになるので、履歴尊重なら `archive` を使うこと
+  (description / README に明示)
+
+### PR2: List 6 種 + tasks recent
+
+Web の Today / Resource ページで参照できる一覧を CLI からも引けるよう拡張。
+tasks 配下に `recent` を追加 + 新規トップレベルコマンドグループ 5 つ
+(`projects` / `tags` / `contexts` / `routines` / `time-blocks`) を追加。
+
+### Added
+
+- `taskchute projects list` (alias `ls`) — プロジェクト一覧。`--archived` /
+  `--all` で表示範囲切替
+- `taskchute tags list` — タグ一覧
+- `taskchute contexts list` — コンテキスト一覧
+- `taskchute routines list` — ルーチン一覧。`--paused` / `--archived` / `--all`。
+  `frequency` は `weekly:1,3,5` のような短縮表記で表示
+- `taskchute time-blocks list` — タイムブロック一覧。`weekdays` は日月火水木金土の
+  漢字 1 文字で表示 (例: `月火水木金`)
+- `taskchute tasks recent [--days 90] [--query <text>] [--limit 100]` —
+  過去 N 日のタスク。`--query` で fuzzy match (ひらがな↔カタカナ正規化込み)
+- 5 つの format helper (`project-row` / `tag-row` / `context-row` /
+  `routine-row` / `time-block-row`) を新設
+
+### Changed
+
+- `taskchute --help` のトップレベルに 5 コマンドグループ追加
+  (`projects` / `tags` / `contexts` / `routines` / `time-blocks`)
+- audit 機構が CLI 経由でも有効化された (PR2 で `createNodeAppContext` が
+  `getLookups` を渡すように変更)。`taskchute tasks update` を実行すると
+  TaskNote に変更履歴が自動記録される
+
+### PR1: Task CRUD パリティ
+
+Web の Today で当たり前にできる task 操作を CLI からも全部できるよう拡張。
+タスク操作系 5 command → **9 command** に。
+
+### Added
+
+- `taskchute tasks update <id-prefix>` — フィールド部分更新。flag は
+  `--title` / `--description` / `--clear-description` / `--estimated <duration>` /
+  `--project <prefix>` / `--clear-project` / `--context <prefix>` /
+  `--clear-context` / `--tag <prefix>` (繰り返し可) / `--no-tags` /
+  `--scheduled HH:MM` / `--clear-scheduled` / `--notify` / `--no-notify` /
+  `--background` / `--no-background`。`--clear-X` で明示クリア、`--no-tags` で
+  全タグ外し。
+- `taskchute tasks delete <id-prefix>` (alias `rm`) — タスク削除。既定は
+  Routine 由来タスクを今日以降に消す時 `routine_expansions` に skip 記録、
+  `--hard` で物理削除のみ。
+- `taskchute tasks skip <id-prefix>` — タスクをスキップ (status → skipped)。
+- `taskchute tasks reopen <id-prefix>` — completed / skipped を planned に
+  戻す。
+
+### Changed
+
+- `taskchute tasks add <title>` に `--project` / `--context` / `--tag` /
+  `--scheduled` / `--notify` / `--background` flag を追加。project / context /
+  tag は id prefix で指定可能 (4 文字以上、曖昧なら候補表示)。
+
+## [0.1.2] - 2026-05-23
+
+### Fixed
+
+- `taskchute --version` が `0.0.0` を表示していたバグを修正。
+  `src/index.ts` に literal 文字列で書いていたバージョンを、tsup の
+  `define` 機能で build 時に `package.json` の version に置換するように
+  変更。以降は version bump 時に build を走らせれば CLI 表示も自動
+  追従する。
+
+### Added
+
+- `src/build-globals.d.ts`: tsup が build 時に置換する識別子
+  (`__PKG_VERSION__`) の TypeScript 型定義。
+
 ## [0.1.1] - 2026-05-23
 
 ### Changed
@@ -57,5 +235,7 @@
   `.github/workflows/publish-cli.yml` workflow からのみ publish 可能な
   構成に切り替えた。
 
+[0.2.0]: https://github.com/fukuchang/TaskChute/releases/tag/cli-v0.2.0
+[0.1.2]: https://github.com/fukuchang/TaskChute/releases/tag/cli-v0.1.2
 [0.1.1]: https://github.com/fukuchang/TaskChute/releases/tag/cli-v0.1.1
 [0.1.0]: https://github.com/fukuchang/TaskChute/releases/tag/cli-v0.1.0

package/README.md

@@ -76,10 +76,44 @@ taskchute tasks done <taskId-or-index>
 | `taskchute unlock` | E2EE passphrase を keyring に保存し、以降のコマンドを対話なしに走らせる |
 | `taskchute lock` | keyring から passphrase を削除 (session は維持) |
 | `taskchute tasks list [--date YYYY-MM-DD]` | タスク一覧表示 |
-| `taskchute tasks add <title> [--duration <min>] [--date <date>]` | タスク追加 |
-| `taskchute tasks start <id>` | タスク開始 |
-| `taskchute tasks pause <id>` | タスク中断 |
-| `taskchute tasks done <id>` | タスク完了 |
+| `taskchute tasks add <title> [--estimated 30m] [--date <date>] [--project <prefix>] [--context <prefix>] [--tag <prefix>...] [--scheduled HH:MM] [--description <text>] [--notify] [--background]` | タスク追加 |
+| `taskchute tasks update <id-prefix> [--title ...] [--description ...] [--clear-description] [--estimated 1h] [--project <prefix>] [--clear-project] [--context <prefix>] [--clear-context] [--tag <prefix>...] [--no-tags] [--scheduled HH:MM] [--clear-scheduled] [--notify] [--no-notify] [--background] [--no-background]` | フィールド部分更新。`--clear-X` で明示クリア、`--no-tags` で全タグ外し |
+| `taskchute tasks delete <id-prefix> [--hard]` / `rm` | タスク削除。既定は Routine 由来なら今日以降は skip 記録、`--hard` で物理削除のみ |
+| `taskchute tasks start <id-prefix>` | タスク開始 |
+| `taskchute tasks pause <id-prefix>` | タスク中断 |
+| `taskchute tasks done <id-prefix>` | タスク完了 |
+| `taskchute tasks skip <id-prefix>` | タスクをスキップ (status → skipped) |
+| `taskchute tasks reopen <id-prefix>` | completed / skipped を planned に戻す |
+| `taskchute tasks recent [--days 90] [--query <text>] [--limit 100]` | 過去 N 日のタスク (fuzzy match 対応) |
+| `taskchute projects list [--archived | --all]` | プロジェクト一覧 |
+| `taskchute tags list [--archived | --all]` | タグ一覧 |
+| `taskchute contexts list [--archived | --all]` | コンテキスト一覧 |
+| `taskchute routines list [--paused | --archived | --all]` | ルーチン一覧 (frequency は `weekly:1,3,5` のような短縮表記で表示) |
+| `taskchute time-blocks list [--archived | --all]` | タイムブロック一覧 |
+| `taskchute projects create <name> [--description ...] [--color ...] [--parent <prefix>] [--started-at YYYY-MM-DD] [--target-end YYYY-MM-DD]` | プロジェクト新規作成 |
+| `taskchute projects update <id-prefix> [--name ...] [--description ...] [--clear-description] [--color ...] [--clear-color] [--parent <prefix>] [--clear-parent] [--started-at YYYY-MM-DD] [--clear-started-at] [--target-end YYYY-MM-DD] [--clear-target-end]` | プロジェクト部分更新 |
+| `taskchute projects archive <id-prefix>` | アーカイブ (タスクの project_id 維持) |
+| `taskchute projects delete <id-prefix>` / `rm` | 物理削除 (タスクの project_id は NULL 化) |
+| `taskchute tags create <name> [--description ...] [--color ...]` | タグ新規作成 |
+| `taskchute tags update <id-prefix> [--name ...] [--description ...] [--clear-description] [--color ...] [--clear-color]` | タグ部分更新 |
+| `taskchute tags archive <id-prefix>` | アーカイブ (タスクの tag_ids 配列維持) |
+| `taskchute tags delete <id-prefix>` / `rm` | 物理削除 (tag_ids 配列に孤児 id が残るので注意) |
+| `taskchute contexts create <name> [--description ...] [--icon ...] [--color ...]` | コンテキスト新規作成 |
+| `taskchute contexts update <id-prefix> [--name ...] [--description ...] [--clear-description] [--icon ...] [--clear-icon] [--color ...] [--clear-color]` | コンテキスト部分更新 |
+| `taskchute contexts archive <id-prefix>` | アーカイブ |
+| `taskchute contexts delete <id-prefix>` / `rm` | 物理削除 (タスクの context_id は NULL 化) |
+| `taskchute routines create <title> --estimated <dur> --frequency <spec> [...]` | ルーチン新規作成。`--frequency` は `daily` / `weekly:1,3,5` / `monthly:1,15` / `custom:CRON` |
+| `taskchute routines update <id-prefix> [...]` | ルーチン部分更新 (**未来 planned task に自動伝播**) |
+| `taskchute routines archive <id-prefix>` | アーカイブ (既存 task の routine_id 維持) |
+| `taskchute routines delete <id-prefix>` / `rm` | 物理削除 (task の routine_id は NULL 化) |
+| `taskchute time-blocks create <name> --start-time HH:MM --end-time HH:MM --weekdays 1,2,3 [...]` | タイムブロック新規作成 (`weekdays` は 0=日 ～ 6=土) |
+| `taskchute time-blocks update <id-prefix> [...]` | タイムブロック部分更新 |
+| `taskchute time-blocks archive <id-prefix>` | アーカイブ |
+| `taskchute time-blocks delete <id-prefix>` / `rm` | 物理削除 |
+| `taskchute tasks set-actual-times <id-prefix> [--start HH:MM] [--end HH:MM] [--clear-start] [--clear-end] [--reset]` | 実績開始/終了時刻を直接指定 (Play 押し忘れリカバリ用) |
+| `taskchute tasks interrupt <target-id-prefix> <title> --estimated <dur> [...]` | 走行中タスクを「割り込み」で分割 (3 タスクを 1 操作で生成) |
+| `taskchute tasks parallel <title> --estimated <dur> [--no-start-immediately] [--background] [...]` | 並列タスク追加 (既定で即計測開始) |
+| `taskchute tasks reorder <id-prefix> --order-index <n> [--scheduled HH:MM] [--clear-scheduled]` | 並び順 (orderIndex) と所属タイムブロックを直接指定 |
 
 詳細オプションは `taskchute <command> --help` で確認。