aizuchi 0.2.0 → 0.4.0

package/dist/shared/schema.js

@@ -64,6 +64,22 @@ export const taskTemplateSchema = z
     priority: z.enum(PRIORITIES).optional(),
 })
     .strict();
+/**
+ * 保存済みビュー定義 (絞り込みプリセット)。よく使うボードの絞り込み (担当 / ラベル / 検索語 /
+ * status) を config に名前付きで保存し、ワンクリックで適用する。
+ * language と同じく config.json を正とする (localStorage は origin=port 単位で分断され git 同期もされない)。
+ * name は chip のラベル (必須)、query/label/assignee/statuses は適用する絞り込み値 (任意)。
+ * .strict で未知フィールドを拒否する (config の typo を可視化)。既定は空配列で後方互換。
+ */
+export const savedViewSchema = z
+    .object({
+    name: z.string().min(1),
+    query: z.string().optional(),
+    label: z.string().optional(),
+    assignee: z.string().optional(),
+    statuses: z.array(z.enum(TASK_STATUSES)).optional(),
+})
+    .strict();
 export const configSchema = z.object({
     projectName: z.string().min(1).default('project'),
     idPrefix: z
@@ -121,8 +137,29 @@ export const configSchema = z.object({
     milestones: z.array(milestoneSchema).default([]),
     // タスクテンプレート定義 (波 VI)。既定は空 = 既存 config と後方互換 (テンプレート UI は非表示)
     taskTemplates: z.array(taskTemplateSchema).default([]),
+    // 保存済みビュー (絞り込みプリセット)。既定は空 = 既存 config と後方互換 (chip 非表示・N-6)。
+    // language と同じくファイル側を正とし、ポート差・案件横断で効き git 同期される (localStorage 不使用)
+    savedViews: z.array(savedViewSchema).default([]),
+    // ビュー切替タブの表示順 + 表示/非表示。順序付き {id, hidden?}。既定は空 = 既定順で全表示 (後方互換)。
+    // id は web 側の既定ビュー集合 (board/critical/...) と突き合わせ、未知 id は無視・未列挙の既定ビューは末尾表示。
+    views: z.array(z.object({ id: z.string().min(1), hidden: z.boolean().optional() })).default([]),
     // 関連資料ディレクトリ (波 VIII)。プロジェクトルートからの相対パス。既定は空 = 機能オフ (UI 非表示)
     docsDirs: z.array(z.string().min(1)).default([]),
+    // ごみ箱 (.kanban/.trash) の同 id あたり退避世代の保持件数。任意・後方互換 (未設定は DEFAULT_TRASH_KEEP)。
+    // 破壊的書込の直前に旧版を .trash へコピー退避し、この件数を超えた古い世代を刈り取る (誤上書きの安全網)
+    trashKeep: z.number().int().positive().optional(),
+    // 停滞アラート閾値 (静かなタスク検知)。status 別に「最後の作業ログから何日で停滞とみなすか」(単位: 日)。
+    // 任意・後方互換 (milestones/docsDirs 前例): 未設定でも DEFAULT_STALL_THRESHOLDS で動く (N-6)。
+    // partial なので個別 status だけ上書き可。done/archive は対象外なので持たない
+    stallThresholds: z
+        .object({
+        in_progress: z.number().int().positive(),
+        todo: z.number().int().positive(),
+        pending: z.number().int().positive(),
+    })
+        .strict()
+        .partial()
+        .optional(),
 });
 /** 既定 config を生成する (N-6: 設定ゼロでも既定値で動作する) */
 export function defaultConfig() {
@@ -340,6 +377,17 @@ export const rejectInputSchema = z
     reason: singleLineString,
 })
     .strict();
+/**
+ * POST /api/tasks/:id/revise の入力 (やり直し依頼。done/in_progress/pending から todo へ戻す)。
+ * reason は任意・改行可 (差し戻しの説明が複数行になりうるため reject の 1 行制約とは別扱い)。
+ * baseMtimeMs があれば PATCH/PUT と同じ mtime 競合検知に乗る (N-3)。
+ */
+export const reviseInputSchema = z
+    .object({
+    reason: z.string().max(2000).optional(),
+    baseMtimeMs: z.number().optional(),
+})
+    .strict();
 // ---------------------------------------------------------------------------
 // AI 設定ファイル管理 (F-4) の境界型
 // ---------------------------------------------------------------------------
@@ -355,6 +403,8 @@ export const fileSaveInputSchema = z
     path: z.string().min(1),
     content: z.string(),
     baseMtimeMs: z.number(),
+    // 'global' = ~/.claude/skills,agents への保存 (省略 = プロジェクトローカル)。グローバルは UI で警告のうえ保存
+    scope: z.enum(['local', 'global']).optional(),
 })
     .strict();
 /** カタログ項目 (skill / agent の frontmatter name/description 抽出。F-4-4) */
@@ -383,6 +433,38 @@ export const commentInputSchema = z
     .strict();
 /** POST /api/tasks/:id/rename の入力 (重複 ID リネーム支援 F-6-5。空き番号へ採番し直す) */
 export const renameInputSchema = z.object({}).strict();
+// ---------------------------------------------------------------------------
+// ごみ箱 (.kanban/.trash) の境界型。破壊的書込の直前に旧版をコピー退避した一覧 + 復元
+// ---------------------------------------------------------------------------
+/** GET /api/trash の退避 1 件 (軽量メタ + プレビュー用本文。frontmatter parse 成功時のみ表示用 title) */
+export const trashItemSchema = z.object({
+    /** 元タスク ID */
+    id: z.string().min(1),
+    /** 退避時刻のエポックミリ秒 (世代の識別子。restore の trashedAt に渡す) */
+    trashedAt: z.number().int().nonnegative(),
+    /** frontmatter が parse できれば title (壊れた退避では null) */
+    title: z.string().nullable(),
+    /** 退避時の status (frontmatter が zod 検証を通った時のみ。壊れた退避は null) */
+    status: z.enum(TASK_STATUSES).nullable(),
+    /** 退避内容の本文 (プレビュー用。frontmatter 以降。parse 不能なら全文) */
+    body: z.string(),
+});
+/** GET /api/trash の応答 (退避一覧。新しい退避が先頭) */
+export const trashListResponseSchema = z.object({
+    items: z.array(trashItemSchema),
+});
+/**
+ * POST /api/tasks/:id/restore の入力 (ごみ箱からの復元)。
+ * trashedAt 省略時は当該 id の最新世代を復元する。空オブジェクト可 (最新復元)。
+ * overwrite が true なら tasks/<id>.md が既存でも上書き復元する (現行は退避してから上書き)。
+ * 未指定 / false なら既存時は 409 (上書きしない・unarchive と対称) のまま。
+ */
+export const restoreInputSchema = z
+    .object({
+    trashedAt: z.number().int().nonnegative().optional(),
+    overwrite: z.boolean().optional(),
+})
+    .strict();
 /**
  * POST /api/members/rename の入力 (member スラッグ変更 / 削除時の移譲)。
  * 全タスクの created_by / assignee の from を to へ付け替える

package/dist/shared/stats.js

@@ -9,6 +9,121 @@ import { parseWorkLogLines } from './digest.js';
 import { TASK_STATUSES } from './schema.js';
 const MS_PER_DAY = 24 * 60 * 60 * 1000;
 const DEFAULT_MAX_BOTTLENECKS = 5;
+/** 停滞アラートの対象ステータス (done/archive は対象外。能動的に進める必要がある 3 状態のみ) */
+export const STALL_STATUSES = ['in_progress', 'todo', 'pending'];
+/**
+ * 停滞アラートの既定閾値 (単位: 日)。設定ゼロでも動く既定値の唯一の集約点 (N-6・ハードコード回避)。
+ * in_progress は能動的に進行中のはずなので短く、todo は着手前で長め、pending は待ち中で中間。
+ */
+export const DEFAULT_STALL_THRESHOLDS = {
+    in_progress: 2,
+    todo: 7,
+    pending: 5,
+};
+/**
+ * 「人の判断待ち」(status='pending' かつ blocked_type='decision') のタスクを抽出する純関数。
+ * AI が blocked_type=decision で pending にしても人間が気づけない問題への read-only 派生表示。
+ * ID 昇順 (数値を考慮した自然順) で返す。新データ源・新依存・API 追加はゼロ。
+ */
+export function deriveDecisionWaits(tasks) {
+    return tasks
+        .filter((t) => t.status === 'pending' && t.blocked_type === 'decision')
+        .map((t) => ({
+        id: t.id,
+        title: t.title,
+        blocked_reason: t.blocked_reason,
+        assignee: t.assignee,
+    }))
+        .sort((a, b) => a.id.localeCompare(b.id, 'en', { numeric: true }));
+}
+/** status が停滞対象 (in_progress/todo/pending) かを型ガードで判定する */
+function isStallStatus(status) {
+    return STALL_STATUSES.includes(status);
+}
+// `## 作業ログ` 見出し行の検出 (level 不問・前後空白許容)。見出し文言は §5.3 / CLAUDE.md テンプレートに準拠。
+const WORKLOG_HEADING_RE = /^\s{0,3}#{1,6}\s+作業ログ\s*$/;
+// 任意の Markdown 見出し行 (セクション境界の検出に使う)。
+const ANY_HEADING_RE = /^\s{0,3}#{1,6}\s+/;
+/**
+ * stats 用に「作業ログセクションだけ」を切り出す (digest は全セクションを拾う現挙動を維持し、本関数は使わない)。
+ * `## 作業ログ` 見出しがあればその配下〜次の見出し直前までを返す。見出しが無ければ本文全体を返す (後方互換)。
+ * 目的: `## やりとり` のコメント行 (`- HH:mm [member]` と同書式) を停滞・完了集計が拾わないようにする (R-review #3)。
+ */
+function workLogBody(body) {
+    const lines = body.split('\n');
+    let start = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (WORKLOG_HEADING_RE.test(lines[i])) {
+            start = i + 1;
+            break;
+        }
+    }
+    if (start === -1)
+        return body; // 作業ログ見出しが無ければ全体 (テスト fixture や旧形式との後方互換)
+    const out = [];
+    for (let i = start; i < lines.length; i++) {
+        if (ANY_HEADING_RE.test(lines[i]))
+            break; // 次の見出し (## やりとり 等) でセクション終了
+        out.push(lines[i]);
+    }
+    return out.join('\n');
+}
+/**
+ * タスクの「最後の活動時刻」を決める (epoch ms と ISO 文字列)。
+ * 優先順位: (1) 作業ログセクションの「最も新しい」日時 → 無ければ (2) frontmatter.updated。
+ * 出現位置の末尾ではなく時刻最大で選ぶ (手編集での過去日付追記やバックフィルで誤判定しないため、R-review #2)。
+ * 作業ログ時刻は offset 無し (ローカル解釈)。updated は offset 付き絶対時刻 (deriveStats と同じ既知近似)。
+ * いずれも parse 不能なら null。
+ */
+function lastActivity(task) {
+    const logs = parseWorkLogLines(workLogBody(task.body));
+    let best = null;
+    for (const log of logs) {
+        const iso = `${log.date}T${log.time}`;
+        const ms = Date.parse(iso);
+        if (Number.isNaN(ms))
+            continue;
+        if (best === null || ms > best.ms)
+            best = { ms, iso };
+    }
+    if (best !== null)
+        return best;
+    const ms = parseIsoMs(task.updated);
+    return ms === null ? null : { ms, iso: task.updated };
+}
+/**
+ * 「静かなタスク (停滞)」を検知する純関数 (既存ボトルネック = pending 滞留のみ とは直交)。
+ * in_progress/todo/pending のうち、最後の作業ログ (無ければ updated) からの経過日数が
+ * status 別閾値 (日) を超えたものを idleDays 降順 → ID 昇順で返す。done/archive は対象外。
+ *
+ * @param tasks 対象タスク (status 不問。内部で対象 status のみ評価する)
+ * @param now 現在時刻 (epoch ms)。経過日数の基準 (Date.now ハードコード禁止・テスト再現性)
+ * @param thresholds status 別閾値 (日)。未指定の status は DEFAULT_STALL_THRESHOLDS を使う (N-6)
+ */
+export function findStalledTasks(tasks, now, thresholds = {}) {
+    const result = [];
+    for (const task of tasks) {
+        if (!isStallStatus(task.status))
+            continue; // done/backlog/proposed/archive は対象外
+        const activity = lastActivity(task);
+        if (activity === null)
+            continue; // 日時が parse 不能なら判定不可 (誤検知を避けスキップ)
+        const limitDays = thresholds[task.status] ?? DEFAULT_STALL_THRESHOLDS[task.status];
+        const idleMs = now - activity.ms;
+        // 閾値「超過」のみ停滞とみなす (ちょうど閾値ぴったりは含めない)
+        if (idleMs <= limitDays * MS_PER_DAY)
+            continue;
+        result.push({
+            id: task.id,
+            title: task.title,
+            status: task.status,
+            lastActivityIso: activity.iso,
+            idleDays: toDays(idleMs),
+        });
+    }
+    // 停滞が深い順 → 同率は ID 昇順 (自然順)
+    return result.sort((a, b) => b.idleDays - a.idleDays || a.id.localeCompare(b.id, 'en', { numeric: true }));
+}
 // 完了記録の偽陽性を避けるための否定文脈ガード (R10-1)。これにヒットする行は完了記録とみなさない。
 // 例: 「未完了の項目」「完了予定を 7/1」「まだ done していない」「isn't finished」
 const COMPLETION_NEGATIVE_RE = /未完了|未完|完了予定|完了見込|完了せず|undone|not\s+(done|finished|closed)|n['’]t\s+(done|finished|closed)/i;
@@ -46,7 +161,8 @@ function isCompletionRecord(message) {
  * 非 JST ブラウザではサイクルタイムが offset 差ぶんずれる (JST 運用なら実害小)。
  */
 function completionMs(task) {
-    const logs = parseWorkLogLines(task.body);
+    // `## やりとり` のコメント行に完了キーワードがあっても拾わないよう、作業ログセクションに限定する (R-review #3)。
+    const logs = parseWorkLogLines(workLogBody(task.body));
     for (let i = logs.length - 1; i >= 0; i--) {
         if (isCompletionRecord(logs[i].message)) {
             const ms = Date.parse(`${logs[i].date}T${logs[i].time}`);