aizuchi 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -5,6 +5,31 @@
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-06-16
+
+「今どうなっているか・次に何をすべきか」の見通しと、堅牢性・操作性を高めるリリース。
+
+### Added (追加)
+
+- **ホーム「次の一手」ビュー**（既定の最初のタブ）: 判断待ち・停滞・クリティカルパスの律速・WIP 超過・新着を
+  1 画面に集約し、開いた瞬間に「今プロジェクトを止めているもの」「次に着手すべきタスク」が分かる。
+  既存の集計ロジックを束ねるだけで、新しい保存先や通信は増やさない。タブの並べ替え・非表示で従来どおり
+  ボードを最初のタブに戻せる。
+- **タスク詳細のタイムラインタブ**: 作業ログ・やりとり・コミットを 1 本の時系列にまとめて表示し、
+  「このタスクで何がいつ起きたか」を一目で追える。
+- **やりとり / 作業ログ / タイムラインの `@member` ハイライト**: 登録メンバー宛のメンションを強調表示。
+  やりとりタブでは投稿者（=あなた）宛のメンションをさらに強調する。
+- **AI 用 CLI に読取系コマンドを追加**（read-only）: `aizuchi task list`（一覧・`--status` / `--assignee` 絞り込み）、
+  `task show <id>`（1 タスクの詳細）、`task next`（依存が解決済みで着手できるタスクをクリティカルパス優先で提示）。
+  AI が「今の状態」「次の一手」をファイル経由で引ける。いずれも `--json` 対応。
+- **キーボードショートカットのヘルプ**: `?` キーまたはヘッダーの「?」ボタンで、⌘K・カードの移動（Space で掴む /
+  矢印で移動）・Enter で詳細・Esc などの一覧を表示。
+
+### Changed (変更)
+
+- 各ビューを Error Boundary で隔離し、1 つのビューの表示エラーがアプリ全体を白画面にしないように
+  （他のタブへ切り替える / 再試行で復帰できる）。
+
 ## [0.3.0] - 2026-06-16
 
 UI を大幅に刷新し、協働ループ・自己診断・グローバル設定編集などを追加した節目のリリース。
@@ -115,7 +140,8 @@ UI をデザイントークン体系で刷新しました。
 - **セキュリティ**: ローカル限定 (127.0.0.1)・書込パス許可リスト + symlink / トラバーサル拒否・
   アトミック書込 + mtime 競合検知・秘匿情報のログ非出力・git 履歴連携 (read-only)。
 
-[Unreleased]: https://github.com/megaphone-tokyo/AIzuchi/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/megaphone-tokyo/AIzuchi/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/megaphone-tokyo/AIzuchi/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/megaphone-tokyo/AIzuchi/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/megaphone-tokyo/AIzuchi/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/megaphone-tokyo/AIzuchi/releases/tag/v0.1.0

package/README.md

@@ -88,9 +88,10 @@ UI 表示言語は英語 / 日本語（en / ja・既定 en）を切り替えら
   マーカー区切りで追記。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` を提供。
-  既存のスキーマ検証・採番直列化・行置換検証を再利用します（生ファイル編集も従来どおり可）。
+- **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` 対応）。
 
 ### そのほか
 

package/dist/bin/aizuchi.js

@@ -5,8 +5,9 @@ import readline from 'node:readline';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { serve } from '@hono/node-server';
 import { DEFAULT_OVERVIEW_PORT, DEFAULT_PORT } from '../shared/schema.js';
+import { analyzeCriticalPath } from '../shared/critical-path.js';
 import { createApp } from '../server/app.js';
-import { loadConfig } from '../server/board.js';
+import { loadArchive, loadBoard, loadConfig } from '../server/board.js';
 import { createEventBus } from '../server/events.js';
 import { cleanupStaleTmpFiles, resolveKanbanReal, writeFileAtomic } from '../server/lib/fs-safe.js';
 import { createOverviewApp } from '../server/overview.js';
@@ -473,8 +474,117 @@ export async function runTaskCli(argv, io = {
                 const view = await ops.appendComment(positional[0] ?? '', opts.get('member') ?? 'claude', positional[1] ?? '');
                 return emit(view, `コメント追記: ${view.frontmatter.id}`);
             }
+            // --- 読取系 (read-only。AI が「今の状態」「次の一手」をファイル経由で引ける) ---
+            case 'list': {
+                // アクティブなタスク一覧。--status / --assignee で絞り込み。書込なし
+                const board = await loadBoard(root);
+                const statusFilter = opts.get('status');
+                const assigneeFilter = opts.get('assignee');
+                const rows = board.tasks
+                    .filter((t) => statusFilter === undefined || t.frontmatter.status === statusFilter)
+                    .filter((t) => assigneeFilter === undefined || t.frontmatter.assignee === assigneeFilter)
+                    .map((t) => ({
+                    id: t.frontmatter.id,
+                    status: t.frontmatter.status,
+                    assignee: t.frontmatter.assignee,
+                    priority: t.frontmatter.priority,
+                    title: t.frontmatter.title,
+                    labels: t.frontmatter.labels,
+                }))
+                    .sort((a, b) => a.id.localeCompare(b.id, 'en', { numeric: true }));
+                if (json) {
+                    io.out(JSON.stringify(rows));
+                }
+                else if (rows.length === 0) {
+                    io.out('(該当タスクなし)');
+                }
+                else {
+                    for (const r of rows)
+                        io.out(`${r.id}\t${r.status}\t${r.assignee ?? '-'}\t${r.title}`);
+                }
+                return 0;
+            }
+            case 'show': {
+                // 1 タスクの詳細 (frontmatter 要約 + 本文)。アクティブ → 無ければ archive を探す
+                const id = positional[0] ?? '';
+                if (id === '') {
+                    io.err(json ? JSON.stringify({ error: 'id required', code: 'invalid_input' }) : 'show には <id> が必要です');
+                    return 1;
+                }
+                const board = await loadBoard(root);
+                const found = board.tasks.find((t) => t.frontmatter.id === id);
+                if (found !== undefined) {
+                    if (json) {
+                        io.out(JSON.stringify(found));
+                    }
+                    else {
+                        const f = found.frontmatter;
+                        io.out(`${f.id}  [${f.status}]  ${f.title}`);
+                        io.out(`assignee: ${f.assignee ?? '-'}  priority: ${f.priority}  labels: ${f.labels.join(', ') || '-'}`);
+                        if (f.depends_on.length > 0)
+                            io.out(`depends_on: ${f.depends_on.join(', ')}`);
+                        if (f.status === 'pending')
+                            io.out(`blocked: ${f.blocked_type ?? '-'} — ${f.blocked_reason ?? '-'}`);
+                        io.out('');
+                        io.out(found.body.trim());
+                    }
+                    return 0;
+                }
+                const archived = (await loadArchive(root)).find((a) => a.id === id);
+                if (archived !== undefined) {
+                    if (json) {
+                        io.out(JSON.stringify({ ...archived, archived: true }));
+                    }
+                    else {
+                        io.out(`${archived.id}  [archived]${archived.title ? `  ${archived.title}` : ''}`);
+                        io.out('');
+                        io.out((archived.body ?? '').trim());
+                    }
+                    return 0;
+                }
+                io.err(json ? JSON.stringify({ error: 'not found', code: 'not_found', id }) : `タスクが見つかりません: ${id}`);
+                return 2;
+            }
+            case 'next': {
+                // 「次に着手できるタスク」= 未完了かつ依存が全て解決済み (active な先行依存なし) の
+                // backlog/todo/in_progress。クリティカルパス上を優先表示する。書込なし
+                const board = await loadBoard(root);
+                const active = board.tasks.filter((t) => t.frontmatter.status !== 'done');
+                const cp = analyzeCriticalPath(active.map((t) => ({ id: t.frontmatter.id, dependsOn: t.frontmatter.depends_on })));
+                const onCp = new Set(cp.criticalPath);
+                const activeIds = new Set(active.map((t) => t.frontmatter.id));
+                const ACTIONABLE = new Set(['backlog', 'todo', 'in_progress']);
+                const ready = active
+                    .filter((t) => ACTIONABLE.has(t.frontmatter.status) &&
+                    t.frontmatter.depends_on.every((d) => !activeIds.has(d)))
+                    .map((t) => ({
+                    id: t.frontmatter.id,
+                    status: t.frontmatter.status,
+                    title: t.frontmatter.title,
+                    onCriticalPath: onCp.has(t.frontmatter.id),
+                }))
+                    .sort((a, b) => {
+                    if (a.onCriticalPath !== b.onCriticalPath)
+                        return a.onCriticalPath ? -1 : 1;
+                    return a.id.localeCompare(b.id, 'en', { numeric: true });
+                });
+                if (json) {
+                    io.out(JSON.stringify({ ready, criticalPath: cp.criticalPath, hasCycle: cp.cycleNodes.length > 0 }));
+                    return 0;
+                }
+                if (cp.cycleNodes.length > 0)
+                    io.out(`⚠ 依存に循環があります: ${cp.cycleNodes.join(', ')}`);
+                if (ready.length === 0) {
+                    io.out('着手可能なタスクはありません (全て完了 / 依存待ち / ブロック中)');
+                    return 0;
+                }
+                io.out('次に着手できるタスク (依存解決済み):');
+                for (const r of ready)
+                    io.out(`- ${r.id} (${r.status})${r.onCriticalPath ? ' ★CP' : ''}  ${r.title}`);
+                return 0;
+            }
             default:
-                io.err('task サブコマンド: add / move <id> <status> / done <id> / block <id> --type --reason / revise <id> [--reason "..."] / log <id> "msg" / comment <id> "msg"');
+                io.err('task サブコマンド: add / move <id> <status> / done <id> / block <id> --type --reason / revise <id> [--reason "..."] / log <id> "msg" / comment <id> "msg" / list [--status S] [--assignee M] / show <id> / next');
                 return 1;
         }
     }