aizuchi 0.4.0 → 0.7.2

package/CHANGELOG.md

@@ -5,6 +5,145 @@
 
 ## [Unreleased]
 
+## [0.7.2] - 2026-07-15
+
+v0.7.1 に続く改善リリース (資料ファイル名の国際化 + 追加のセキュリティ堅牢化 + UI 競合修正)。
+
+### Added (追加)
+
+- 資料 (`docsWriteDirs`) のファイル名・フォルダ名に、日本語・全角・空白などの Unicode 文字を使える
+  ようにしました (これまでは ASCII のみ)。
+
+### Security (セキュリティ)
+
+- 資料のファイル名・フォルダ名の検証を Unicode プロパティベース (`\p{Cc}\p{Cf}\p{Zl}\p{Zp}` + `u`
+  フラグ) に強化し、不可視文字 (bidi 制御・zero-width・tag 文字 U+E0000-E007F・SOFT HYPHEN 等) を用いた
+  ファイル名偽装 (Trojan Source / homograph) を拒否するようにしました。新規作成する中間フォルダ名も同じ
+  規則で検証します。単体絵文字・国旗・VS16 付き絵文字などの表示可能な文字は引き続き許可します
+  (`127.0.0.1` 単一信頼ユーザー前提のため実害は限定的ですが、AI 生成パスの混入・多人数運用への防御を強化)。
+
+### Fixed (修正)
+
+- 設定・タスク・資料の保存で、mtime 競合以外の理由による 409 応答が競合ダイアログに渡ってクラッシュ
+  しうる問題を防ぎました (409 応答の形を検証し、競合形のときだけ競合ダイアログを表示します)。
+- ボードのライブ更新で、古い応答が新しい状態を上書きしうる競合を、世代番号の比較を純関数に切り出して
+  防ぎました (内部堅牢化)。
+- ごみ箱 (`.kanban/.trash`) への退避処理のベストエフォート経路を共通ヘルパに集約しました (内部整理)。
+
+## [0.7.1] - 2026-07-10
+
+プロジェクト全体レビューで見つかった不具合の修正リリース (セキュリティ + バグ修正)。
+
+### Security (セキュリティ)
+
+- AI 用 CLI (`aizuchi task move / done / block / revise / log / comment`) のファイル読込を、HTTP API と
+  同じ hardened な読込 (symlink 非追従 + パス封じ込め) に統一しました。これまで CLI 経路だけがタスク
+  ファイルを生の読込で扱っており、タスクファイルが外部への symlink だった場合にその内容がごみ箱
+  (`.kanban/.trash`) へコピーされうる非対称がありました (重要度: Critical・`127.0.0.1` 単一信頼ユーザー
+  前提で実害は限定的)。symlink のタスクファイルは「見つからない」として拒否されます。
+
+### Fixed (修正)
+
+- 承認トレース (`[approve]`) の検出を作業ログの承認記録に限定し、やりとりコメントや `aizuchi log` の自由
+  入力で提案モード違反の警告を無害化できてしまう穴を塞ぎました。
+- AI 用 CLI でのタスク起票時にも、関連資料 (`related_docs`) の許可ディレクトリ検証を行うようにしました
+  (HTTP API と対称化)。
+- 統計の完了日時の集計を、作業ログの時刻が最大の完了記録を採用する方式に統一しました (バックフィル
+  されたログ行で完了日を取り違えないように)。
+- `status` が `pending` のとき `blocked_reason` が空白のみでも無効として扱うようにしました。
+- 設定ファイルビューで、ファイルを連続で切り替えたときに表示中のファイルと内容が食い違う競合を防ぎました。
+
+(内部: テスト追加・ドキュメント整合・依存ツール整理などの保守性改善も含みます)
+
+## [0.7.0] - 2026-06-17
+
+「固める」リリース。ユーザー向けの新機能追加はなく、セキュリティ・保守性・配布を整えました。
+
+### Security (セキュリティ)
+
+- ファイルの書込・読込で、対象の **親ディレクトリ symlink の TOCTOU race** に対する封じ込め (containment) の
+  再検査を追加。並行してローカルにファイルを書ける攻撃者が、書込/読込対象の親ディレクトリを外部への symlink に
+  すり替えてプロジェクト外へ書込/読出しできる経路 (重要度: Important) を塞ぎました。`127.0.0.1` 限定・単一信頼
+  ユーザー前提のため実害は限定的ですが、「書込・読込はプロジェクト配下のみ」という封じ込めを、時間軸を突く攻撃に
+  対しても保つよう強化しています。
+- 資料 (ドキュメント) の削除を、タスク削除と同じ **「ごみ箱へ退避できた時だけ消す」fail-closed** に統一しました
+  (退避できない場合は削除を中止)。
+- ごみ箱への退避 ID に資料のパスを含め、別ディレクトリにある同名資料の退避世代が混ざらないよう修正しました。
+
+### Changed (変更)
+
+- raw frontmatter の 1 フィールド書換ロジックを共通化しました (依存 / 優先度 / 関連資料の 3 箇所)。挙動は変わらない
+  内部リファクタです。
+- 保守性ツールチェーンとして **biome** (lint / format) を導入しました (`npm run lint` / `npm run format`)。
+
+### Docs (ドキュメント)
+
+- README を **英語主体** にし (npm ページ向け)、日本語版を `README.ja.md` に分離しました。冒頭で言語を切り替えられます。
+
+## [0.6.0] - 2026-06-17
+
+複数人・複数 AI での運用と、「見たいものへの集中」を助ける機能を加えたリリース。
+
+### Added (追加)
+
+- **「自分宛」フィルタ**: ヘッダーで自分 (担当メンバー) を選び、ワンタップで「今、自分に来ているタスク」だけに
+  絞り込めるように。担当が自分のもの・本文で自分が `@メンション` されたもの・自分が起票して承認待ち (proposed) の
+  ものをまとめて表示します。複数人 / 複数 AI で動かしているとき、自分のキューを朝一で確認できます。選択は
+  このブラウザだけに保存され、タスクファイルは変更しません。
+- **ピン留め / フォーカス**: 注目したいタスクをカードや詳細から 📌 でピン留めし、ホームの先頭に固定表示。
+  完了・アーカイブ済みになったピンは自動で隠れます。「次の一手 (クリティカルパス)」の自動集計とは別に、
+  自分で選んだ注目タスクをいつでも見られます。
+- **カードからのクイックコメント**: 詳細パネルを開かずに、カードから直接 `## やりとり` へひとことコメントを
+  追記できるように。AI とのやり取りの往復が一段速くなります。
+- **AI 稼働ヒートマップ**: 統計ビューに、作業ログの時刻を曜日 × 時間帯で集計したヒートマップを追加。
+  「AI がいつ動いているか」を一目で把握できます (表示のみ)。
+- **タスクの完全削除**: タスク詳細に「完全に削除」を追加 (アーカイブが第一候補、削除は危険操作として分離・
+  確認付き)。削除するタスクは消す前に必ずごみ箱 (`.kanban/.trash`) へ退避するので、あとから復元できます。
+  退避に失敗した場合は削除を中止します (取り返しのつかない消失を防ぐため)。
+
+### Changed (変更)
+
+- 長いリスト (アーカイブ / ごみ箱 / 日次ダイジェスト) の描画を `content-visibility` で最適化し、項目が
+  多いときのスクロールを軽くしました。表示内容は変わりません。
+
+## [0.5.0] - 2026-06-17
+
+資料 (ドキュメント) をボード上で作って育てられるようにし、依存・優先度のその場編集や AI 参加者の状態把握を加えたリリース。
+
+### Added (追加)
+
+- **関連資料の作成・編集・削除**: これまで読むだけだった「関連資料」を、ボード上で新規作成・編集・削除できるように。
+  保存先は新しい設定 `docsWriteDirs` に列挙したディレクトリのみ (既定は空 = 機能オフ・読取専用の `docsDirs` と分離)。
+  保存はアトミック (一時ファイル→rename)、上書きは保存時刻 (mtime) 比較で競合を検知、削除は `.kanban/.trash` へ退避して
+  から消す (復元可能)。保存ダイアログで親フォルダ選択 + 新規フォルダ作成 + ファイル名指定。資料から直接タスクを起票する
+  導線付き。パスは正規化 + symlink 解決後にプロジェクト配下のみ許可 (パストラバーサル対策)。
+- **資料エディタのシンタックスハイライト**: Markdown を編集中、見出し・太字・コード・リスト・リンクなどが色分け表示
+  されるように。依存ライブラリを足さない自前実装で、ハイライトは本文を一切書き換えない。
+- **資料エディタの横並び表示**: 編集とプレビューをタブ切替だけでなく **横に並べて同時に** 見られるように (既定)。
+  入力に追従するライブプレビュー付き。画面が狭いときは自動で縦積みに切り替わる。全幅の編集 / プレビューも選べる。
+- **依存・優先度のその場編集**: タスク詳細の「メタ」タブで depends_on (依存) と priority をクリック操作で編集できるように。
+  クリティカルパスを見ながらその場で依存関係や優先度を組み替えられる。保存は既存の競合検知に乗る。
+- **AI オンボーディング診断パネル**: 参加している AI メンバーごとに、タスクの書式ミス・未登録メンバーの使用・設定の問題を
+  「直し方」付きで一覧表示する読取専用パネル。AI が規約どおりに参加できているかを人間が把握できる。
+- **設定画面でのディレクトリ編集**: 資料の読取先 (`docsDirs`) と書込先 (`docsWriteDirs`) を設定画面の GUI から
+  追加・削除できるように。これまで config.json を手で編集する必要があった資料機能の有効化が、画面から行える。
+- キーボードショートカットのヘルプ (`?`) に **「AI への導入指示をコピー」ボタン**を追加。AI エージェント
+  (Claude 等) にこのプロジェクトへ AIzuchi 経由で参加してもらうための指示文を、プロジェクト名・AI メンバー ID・
+  起票モード (free / proposal) を反映してワンクリックでコピーできる。新規プロジェクトのオンボーディングが速くなる。
+- **`serve` のポート自動フォールバック**: 起点ポート (既定 `5151`) が使用中のとき、自動で次の空きポート
+  (`5152`, `5153`…) を探して起動するように。複数プロジェクトを同時に `serve` してもポート衝突で止まらない。
+  起点と違うポートで起動した場合はその旨をログに出す。起点は毎回 `5151` から試すため、次回起動時に空いていれば
+  `5151` に戻る (状態は保存しない)。`--port` を明示した場合のみ従来どおり固定 (使用中ならエラー終了)。
+  バインド先は `127.0.0.1` 固定のまま変えない (N-1)。
+
+### Changed (変更)
+
+- マイルストーンの「対応履歴」の行で、タイトル列を固定幅にして**本文 (サマリ) の開始位置を全行で揃える**ように。
+  これまではタイトルの文字数ぶんだけ幅が変わり本文の左端がバラついていた。収まらないタイトルは `…` で省略し、
+  全文は hover (title 属性) とクリックで確認できる。マイルストーン所属タスク一覧 (status を出す行) は対象外。
+- アクセシビリティ改善: いくつかの入力欄 (コメント投稿者・コメント入力・メンバー種別・詳細 JSON エディタ) に
+  適切なラベル (aria-label) を付与し、ブラウザ開発者ツールのフォーム警告を解消。
+
 ## [0.4.0] - 2026-06-16
 
 「今どうなっているか・次に何をすべきか」の見通しと、堅牢性・操作性を高めるリリース。

package/README.ja.md

@@ -0,0 +1,213 @@
+[English](README.md) | 日本語
+
+# AIzuchi
+
+**AI進捗管理カンバンダッシュボード**（npm / CLI 名: `aizuchi`）
+
+CLI 型 AI コーディングエージェント（Claude Code 等）に作業を委任するプロジェクトで、人間が
+ブラウザ上のカンバンボードからタスクの進捗を一望・操作するためのローカル専用ツールです。
+タスクは `.kanban/` 配下のプレーンテキスト（Markdown + YAML frontmatter）が唯一の正で、
+AI も人間も通常のファイル読み書きだけで参加できます。
+
+「相槌（あいづち）」＝対話せずに通じ合う、AI との意思疎通を表す命名です。
+
+- **ローカル限定**: `127.0.0.1` のみにバインドし、外部送信・テレメトリは一切しません。
+- **ファイルが唯一の正**: DB を使いません。git 管理でき、サーバー停止中も読めます。
+- **規約ベースの AI 連携**: AI は専用 API なしで、ファイル読み書きだけで参加します。
+
+変更履歴は [CHANGELOG.md](CHANGELOG.md) を参照してください。
+
+## 必要環境
+
+- Node.js **20.1 以上**（`fs.readdir` の `recursive` を使うため）
+- macOS / Linux / WSL（Windows ネイティブはベストエフォート）
+
+## クイックスタート
+
+```bash
+# 対象プロジェクトのディレクトリ直下で実行する
+npx aizuchi init     # .kanban/ を生成 + CLAUDE.md へ運用規約をマーカー区切りで追記
+npx aizuchi          # = serve。http://127.0.0.1:5151 でボードを起動（Ctrl+C で終了）
+
+# 複数プロジェクトをまとめて見る（read-only 集約・既定ポート 5152）
+npx aizuchi overview <dir...>   # 例: npx aizuchi overview ~/proj-a ~/proj-b
+```
+
+- `init` は既存ファイルを壊しません。既に `.kanban/` があれば安全に中断します。
+  CLAUDE.md は末尾にマーカー（`<!-- aizuchi:begin -->`〜`<!-- aizuchi:end -->`）区切りで追記し、
+  再実行時は同区間だけを置き換えます（冪等）。撤去は `.kanban/` 削除とマーカー区間削除だけで完了します。
+- `--port <番号>` でポート変更、`--member <ID>` で AI のメンバー ID 指定（config.members に未登録なら
+  `ai` 種別で追加）、`--yes` で確認プロンプト省略。
+- `overview` は各 dir の `.kanban` を読み取り専用で集約表示します（編集・起票・D&D なし）。
+  `.kanban` の無い dir や同一 dir の重複指定は明確なエラーで起動を拒否します。既定ポートは
+  serve（5151）と衝突しない 5152 で、`--port <番号>` で変更できます。
+- `127.0.0.1` 以外にはバインドせず、外部へのネットワーク送信は一切行いません。
+
+## できること
+
+ブラウザのボードで AI への委任を一望・操作します。エディタや AI がファイルを書き換えると、
+watcher → SSE で開いているボードへ約 1 秒以内に反映されます（ライブ更新）。
+UI 表示言語は英語 / 日本語（en / ja・既定 en）を切り替えられます。
+
+### ボード運用
+
+- **ドラッグ＆ドロップ**: カラム移動で frontmatter の `status` / `updated` だけをピンポイント書換（本文は保全）。
+  Pending へ移すと種別（decision / external / dependency）と理由を尋ねるダイアログが出ます。
+- **検索フィルタ**: タイトル / ラベル / 担当でカードを絞り込み。
+- **Saved Views（保存済みビュー）**: 絞り込み条件を config に名前付きで保存し、chip からワンクリックで適用。
+- **新着ハイライト**: 画面を見ていない間に AI が動かしたタスク（status 変化 / 作業ログ追記 / 新規）を
+  カードのハイライトと「新着」バッジで可視化。カードを開くと既読化、ヘッダから一括既読も可能。
+- **停滞バッジ**: 一定期間更新が止まったタスクにバッジを表示（閾値は status 別に設定可能）。
+- **差し戻し（やり直しを依頼）**: カード / 詳細から理由を添えて `todo` へ戻し、作業ログに記録。
+  直近の差し戻し理由は再依頼の指示コピーに自動で載ります。
+- **複数選択の一括指示コピー**: 複数選択モードでカードを選び、依存関係のトポロジカル順に並べた
+  1 つの指示文へまとめてクリップボードへコピー（AI へのバッチ委任を 1 操作で）。
+- **ドラッグ横パン**: カラムの空白部分を掴んで横スクロール（カード等のインタラクティブ要素からの操作は除外）。
+
+### 見通し
+
+- **クリティカルパス**: `depends_on` の DAG をトポロジカル深さで列配置し、クリティカルパスを強調。
+  循環は検出して警告し、再編成の指示コピーも提供。
+- **マイルストーン**: 予定表（milestone 別・done/total 付き）と対応履歴（月別）の 2 ペイン表示。
+- **日次ダイジェスト**: 日付別に作業ログをまとめて表示。
+- **統計**: 完了数推移 / サイクルタイム / ステータス滞留 / member 別完了数 / ボトルネック /
+  停滞中（静かな）タスクの一覧。
+
+### 管理と健全性
+
+- **アーカイブ検索 + 復元**: done タスクを archive へ退避し、一覧・検索・プレビュー。
+  「ボードに戻す」で `tasks/` へ復元（unarchive）。
+- **ごみ箱（.trash 退避 + 復元）**: タスクを破壊的に書き換える直前に旧版を `.kanban/.trash/` へ
+  自動退避する安全網。一覧・現行との差分プレビュー・復元が可能（誤上書きからの回復）。
+- **AI 設定ファイル管理**: `aiConfigPaths` で許可したファイル（CLAUDE.md / settings 等）を
+  GUI から編集（JSON 構文チェック・`.bak` バックアップ・パーミッション保全）。
+- **git 履歴連携（read-only）**: 詳細パネルのコミットタブで、タスク ID を含むコミット履歴を表示。
+  `git log` を read-only で実行するだけで、fetch / pull 等の外部通信はしません。
+
+### AI 連携規約 + CLI
+
+- **規約ベースの連携**: `init` が CLAUDE.md に運用規約（着手 / 進捗 / 完了 / ブロック / 起票 / 書式）を
+  マーカー区切りで追記。AI は専用 API なしでファイルを読み書きするだけで参加できます。
+- **提案ワークフロー**: `aiTaskCreation` が `proposal` のとき、AI 起票は `proposed` で入り、
+  承認 / 却下を経て `todo` へ。モード違反は警告で検知。
+- **AI 用 CLI（必須でない安全弁）**: 書込系 `aizuchi task add / move <id> <status> / done <id> /
+  block <id> --type --reason / log <id> "msg" / comment <id> "msg" / revise <id> --reason` と、
+  読取系 `list [--status S] [--assignee M] / show <id> / next`（着手可能なタスクを依存解決順に提示）を提供。
+  いずれも既存のスキーマ検証・採番直列化・行置換検証を再利用します（生ファイル編集も従来どおり可・`--json` 対応）。
+
+### そのほか
+
+- **複数案件横断 overview**: `aizuchi overview <dir...>` で複数 `.kanban` を read-only 集約表示。
+- **コマンドパレット ⌘K**: ビュー切替 / タスク検索ジャンプ / 起票 / 設定を 1 操作で。
+- **タスク詳細**: Markdown プレビュー / 本文編集（保存時に競合検知 → 行差分提示）/
+  作業ログ・やりとり（双方向コメント）のタイムライン。
+- **警告バナー**: 壊れた frontmatter・重複 ID・未登録メンバー・不正な config を表示（ボードは落ちません）。
+
+## 開発
+
+```bash
+npm install          # 依存インストール
+npm run dev          # 開発: Vite + API を 1 プロセスで起動（http://127.0.0.1:5173 など）
+npm run build        # web を dist/web にビルド + server/shared を dist にコンパイル
+npm run serve        # ビルド済み dist を 1 プロセスで配信（= node dist/bin/aizuchi.js serve）
+npm test             # vitest
+npm run typecheck    # tsc（server）+ tsc -p web/tsconfig.json（web）
+```
+
+- 開発時は Vite の `configureServer` に Hono アプリをマウントし、`npm run dev` 一発で SPA と API の
+  両方が立ち上がります（proxy も concurrently も不要）。
+- 別プロジェクトを開発対象にしたい場合は `AIZUCHI_DEV_ROOT=/path/to/project npm run dev`。
+
+## 構成
+
+```
+                  ┌──────────── 1 プロセス (Node.js) ────────────┐
+ ブラウザ ──HTTP──▶│  静的配信 (dist/web)  REST API   SSE        │
+ (React SPA)  ◀SSE─│  server/static.ts    server/app.ts events  │──watch/read/write──▶ .kanban/
+                  │           chokidar watcher (server/watcher) │                     (プレーンテキスト)
+                  └────────────────────────────────────────────┘            ▲
+                                                                  AI / 人間が直接編集 or CLI
+```
+
+```
+aizuchi/
+├── bin/aizuchi.ts    # CLI エントリ（init / serve / task / overview）。dist/bin/aizuchi.js にコンパイル
+├── server/           # Hono アプリ・watcher・静的配信・ファイル I/O
+│   ├── app.ts        #   REST API（board / tasks / events）+ Host 検証 + onError
+│   ├── overview.ts   #   複数 .kanban の read-only 集約（aizuchi overview・既定ポート 5152）
+│   ├── board.ts      #   .kanban 読込・zod 検証・警告生成
+│   ├── watcher.ts    #   chokidar（debounce 200ms）→ SSE
+│   ├── static.ts     #   ビルド済み SPA の配信（トラバーサル拒否）
+│   └── lib/          #   task-file / pinpoint / id / fs-safe / time / git / trash / task-ops
+├── web/              # Vite + React SPA（ビルド成果物を dist/web に同梱）
+│   └── src/          #   App / useBoard / components / lib
+├── shared/           # task / config の zod スキーマ・型・行 LCS diff（server / web 共有）
+├── templates/        # config.json / claude-rules.md（init が生成）
+└── docs/             # decisions.md ほか
+```
+
+## データ仕様（抜粋）
+
+- タスク = `.kanban/tasks/<ID>.md`（1 タスク 1 ファイル、**ID＝ファイル名**）。
+- frontmatter: `id` / `title` / `status` / `assignee` / `created_by` / `priority` / `labels` /
+  `blocked_type` / `blocked_reason` / `depends_on` / `milestone` / `created` / `updated`。
+- `status`: `proposed` / `backlog` / `todo` / `in_progress` / `pending` / `done`。
+- 日時は ISO 8601（タイムゾーン付き、例: `2026-06-10T10:00:00+09:00`）。UTC へ変換しません。
+- 設定は `.kanban/config.json`（プロジェクト名・ID 接頭辞・ポート・メンバー・カラム・マイルストーン・
+  タスクテンプレート・保存済みビュー・停滞閾値・言語 ほか）。設定ゼロでも既定値で動作します。
+
+各フィールドの enum 値・必須条件など完全な frontmatter スキーマは、`aizuchi init` が `CLAUDE.md` に追記する運用規約（frontmatter スキーマ表）に記載されます。init 後すぐ手元で確認できます。
+
+## 手動確認チェックリスト（受け入れ基準 / DoD）
+
+`npm run build` 後に対象プロジェクトで `node dist/bin/aizuchi.js init` → `... serve` を実行し、ブラウザで確認します。
+
+- [ ] **init**: `node bin/aizuchi.js init` で `.kanban/`（config.json・tasks/・archive/・README）が生成され、
+      CLAUDE.md にマーカーコメント区切りで運用規約が追記される（既存があれば末尾追記、再実行は同区間のみ置換、
+      既存 `.kanban/` があれば安全に中断）。
+- [ ] **serve**: `node bin/aizuchi.js serve` で `http://127.0.0.1:5151` にボードが表示される。127.0.0.1 以外に
+      バインドしない。
+- [ ] **起票**: 追加モーダルからタスクを作成すると `tasks/TASK-00X.md` が生成され、ID が連番になる
+      （起票者は members から選択、その ID が `created_by` に入る）。
+- [ ] **D&D**: カラム移動で frontmatter の `status` / `updated` だけが変わる（`git diff` で本文保全を確認）。
+- [ ] **ライブ反映**: エディタで直接タスクファイルを書き換えると 1 秒以内にボードへ反映される。
+- [ ] **保留表示**: pending カードに保留種別（色分けバッジ）と理由が表示され、in_progress カードに
+      「最終更新 ◯分前」が表示される。
+- [ ] **警告**: frontmatter を壊したファイルを置くと警告バナーに表示され、ボード自体は落ちない。
+- [ ] **詳細**: タスク詳細でプレビュー・編集・作業ログのタイムラインが使える。保存時に外部変更と競合したら
+      上書き確認（差分提示）が出る。
+- [ ] **アーカイブ / ごみ箱**: done をアーカイブ → アーカイブビューから復元できる。破壊的書換の前に
+      `.kanban/.trash/` へ退避され、ごみ箱から復元できる。
+- [ ] **ネットワーク**: 動作中、外部へのネットワーク通信が一切発生しない。
+- [ ] **終了**: ブラウザでボードを開いたまま `Ctrl+C` で serve が速やかに終了する。
+- [ ] **再現性**: 本 README の手順だけで第三者が環境構築〜起動まで再現できる。
+
+## アクセシビリティ
+
+キーボードとスクリーンリーダーでの操作を考慮しています。
+
+- **キーボード操作**: フォームやボタンは Tab で移動・操作できます。コマンドパレット（⌘K / Ctrl+K）から
+  ビュー切替・タスク検索ジャンプ・起票・設定をキーボードだけで実行できます。
+- **キーボードでのカード移動**: カードにフォーカスして **Space で掴み**、矢印キーでカラム間を移動、
+  再度 Space で確定（Enter はカード詳細を開く）。ポインタ D&D と同じ status 更新経路・Pending 行きは保留ダイアログを起動。
+- **モーダル**: 開いた時に内部へフォーカスを移し、Tab / Shift+Tab はダイアログ内をループ（focus trap）、
+  Escape で閉じ、閉じたら元の要素へフォーカスを戻します。
+- **ARIA / 役割**: カラムやカード、ツールバー、ダイアログに `role` と `aria-label` を付与しています。
+
+## 技術スタック
+
+Node.js 20.1+ / Hono + @hono/node-server / chokidar / SSE / React 18 + TypeScript + Vite /
+@dnd-kit / react-markdown + remark-gfm / gray-matter / zod / CSS Modules / vitest。
+
+### 主要スタックに追加した依存とその理由
+
+- **@hono/node-server** — Hono を Node ランタイムで起動し、ビルド済み SPA を静的配信するため
+- **js-yaml (+ @types/js-yaml)** — gray-matter に `JSON_SCHEMA` エンジンを注入し、`+09:00` 付き日時を Date 化せず文字列のまま往復させるため（gray-matter 内蔵の旧 3.x に transitive 依存しない）
+- **@vitejs/plugin-react** — Vite で React（JSX / Fast Refresh）を使うため
+- **@dnd-kit/utilities** — @dnd-kit ファミリ。D&D の CSS transform 補助
+- **tsx** — 開発時に TypeScript サーバーを直接実行するため（本番は dist のコンパイル済み JS を使用）
+- **typescript / vitest / @types/\*** — 型安全とテストの基盤
+
+## ライセンス
+
+MIT