aizuchi 0.1.0 → 0.2.0

package/README.md

@@ -43,6 +43,8 @@ npx aizuchi overview <dir...>   # 例: npx aizuchi overview ~/proj-a ~/proj-b
 
 - **カンバンボード**: config の `columns` どおりにカラム表示。カードに ID・タイトル・担当（human/ai の種別を
   色で区別）・優先度・ラベル・最終更新からの経過時間を表示。
+  カラム名は `columns[].label` が無ければ UI の表示言語に追随します（`label` を書けばカスタム名として固定。
+  既存の config で日本語表示にしたい場合は `label` 行を削除してください）。
 - **ドラッグ＆ドロップ**: カラム移動で frontmatter の `status` / `updated` だけをピンポイント書換（本文は保全）。
   Pending へ移すと種別（decision / external / dependency）と理由を尋ねるダイアログが出ます。
 - **ライブ反映**: エディタや AI がファイルを変更すると、watcher → SSE で開いているボードへ約 1 秒以内に反映。
@@ -106,7 +108,7 @@ aizuchi/
 - 設定は `.kanban/config.json`（プロジェクト名・ID 接頭辞・ポート・メンバー・カラム ほか）。
   設定ゼロでも既定値で動作します。
 
-詳細は開発リポ AIzuchi-DEV の `_docs/260610_要件定義所/aizuchi-要件定義書.md`（§5 データ仕様）を参照。
+各フィールドの enum 値・必須条件など完全な frontmatter スキーマは、`aizuchi init` が `CLAUDE.md` に追記する運用規約（frontmatter スキーマ表）に記載されます。init 後すぐ手元で確認できます。
 
 ## 手動確認チェックリスト（受け入れ基準 / DoD）
 
@@ -135,14 +137,14 @@ aizuchi/
 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 補助（sortable はカラム内並べ替えが入る Phase 2 で追加）
 - **tsx** — 開発時に TypeScript サーバーを直接実行するため（本番は dist のコンパイル済み JS を使用）
-- **typescript / vitest / @types/\*** — 型・テスト基盤（要件定義書 §4.2・§5 が前提とするもの）
+- **typescript / vitest / @types/\*** — 型安全とテストの基盤
 
 ## ライセンス
 

package/dist/server/app.js

@@ -4,7 +4,7 @@ import { Hono } from 'hono';
 import { bodyLimit } from 'hono/body-limit';
 import { HTTPException } from 'hono/http-exception';
 import { streamSSE } from 'hono/streaming';
-import { commentInputSchema, configSchema, fileSaveInputSchema, renameInputSchema, findMemberViolations, moveInputSchema, newTaskInputSchema, NEW_TASK_BODY, rejectInputSchema, saveInputSchema, summarizeZodError, taskFrontmatterSchema, taskIdSchema, } from '../shared/schema.js';
+import { commentInputSchema, configSchema, fileSaveInputSchema, memberRenameInputSchema, renameInputSchema, findMemberViolations, moveInputSchema, newTaskInputSchema, NEW_TASK_BODY, rejectInputSchema, saveInputSchema, summarizeZodError, taskFrontmatterSchema, taskIdSchema, } from '../shared/schema.js';
 import { loadArchive, loadBoard, loadConfig, loadTaskView } from './board.js';
 import { createEventBus } from './events.js';
 import { allocateNextId, createSerialQueue } from './lib/id.js';
@@ -12,7 +12,7 @@ import { assertDirInsideKanban, FileExistsError, PathValidationError, readKanban
 import { buildDocsTree, readDoc } from './lib/docs.js';
 import { findCommitsForTask } from './lib/git.js';
 import { buildCatalog, buildFileTree, fileMtime, readConfigFile, saveConfigFile } from './lib/files.js';
-import { applyPinpointPatch, renameTaskId, replaceDependsOnId, verifyPinpointResult, verifyRename, } from './lib/pinpoint.js';
+import { applyPinpointPatch, renameTaskId, replaceDependsOnId, replaceMemberKeys, verifyMemberRename, verifyPinpointResult, verifyRename, } from './lib/pinpoint.js';
 import { appendCommentLine, appendWorkLogLine, replaceBody } from './lib/proposal.js';
 import { parseTaskFile, serializeTaskFile, TaskFileParseError } from './lib/task-file.js';
 import { archiveMonth, nowIso, workLogTimestamp } from './lib/time.js';
@@ -578,6 +578,83 @@ export function createApp(options) {
         });
     });
     // ---------------------------------------------------------------------
+    // POST /api/members/rename — member スラッグ変更 / 削除時の移譲。
+    // 全タスク (tasks/ のみ。archive は歴史として触らない) の created_by / assignee の
+    // from を to へ付け替える。作業ログ内の [member] 表記も歴史なので書き換えない。
+    // updated は更新しない (メタデータ移行であり経過時間表示を汚さない)。
+    // ---------------------------------------------------------------------
+    app.post('/api/members/rename', async (c) => {
+        const input = memberRenameInputSchema.safeParse(await c.req.json().catch(() => ({})));
+        if (!input.success) {
+            return c.json({ error: '入力が不正', issues: summarizeZodError(input.error) }, 400);
+        }
+        const { from, to } = input.data;
+        return enqueue(async () => {
+            const kanbanReal = await getKanbanReal(); // ループ前に realpath 信頼境界を一度確立 (F-6-5 連鎖更新と同じ)
+            let names = [];
+            try {
+                names = await fs.readdir(tasksDir);
+            }
+            catch {
+                names = [];
+            }
+            let renamed = 0;
+            const skipped = [];
+            for (const name of names) {
+                if (!name.endsWith('.md'))
+                    continue;
+                const p = path.join(tasksDir, name);
+                let content;
+                try {
+                    content = await readKanbanFile(p, kanbanReal); // containment + symlink 非追従 (symlink は対象外)
+                }
+                catch {
+                    continue;
+                }
+                let before;
+                try {
+                    before = parseTaskFile(content);
+                }
+                catch {
+                    continue; // 破損ファイルは対象外 (既存の invalid_task 警告に任せる)
+                }
+                const keys = [];
+                if (before.data.created_by === from)
+                    keys.push('created_by');
+                if (before.data.assignee === from)
+                    keys.push('assignee');
+                if (keys.length === 0)
+                    continue;
+                const patched = replaceMemberKeys(content, keys, to);
+                let after;
+                try {
+                    after = parseTaskFile(patched);
+                }
+                catch {
+                    skipped.push(name);
+                    continue;
+                }
+                // verify-after-patch: 対象キーだけが to に変わり他フィールド/本文が不変かを書込前に検証。
+                // 未対応表記は書き換えずスキップし、応答で列挙する (silent な取りこぼしを可視化)
+                const drift = verifyMemberRename(before, after, keys, to);
+                if (drift !== null) {
+                    skipped.push(name);
+                    continue;
+                }
+                // 書込失敗 (fs エラー等) も全体を中断させず skipped に積んで続行する —
+                // 途中失敗で renamed/skipped の進捗が失われると部分適用の把握ができなくなる
+                try {
+                    await safeWriteFile(p, patched, [kanbanDir]);
+                    renamed += 1;
+                }
+                catch {
+                    skipped.push(name);
+                }
+            }
+            return c.json({ renamed, skipped });
+        });
+    });
+    // ---------------------------------------------------------------------
     // GET /api/config — 生 config JSON を返す (設定画面 F-5 の編集元)
     // ---------------------------------------------------------------------
     app.get('/api/config', async (c) => {

package/dist/server/lib/pinpoint.js

@@ -137,6 +137,56 @@ export function replaceDependsOnId(raw, oldId, newId) {
     }
     return changed ? bom + lines.join('\n') : raw;
 }
+/**
+ * member 移譲: 指定キーの frontmatter 行を `key: <to>` に置き換える (本文・他フィールドは保全)。
+ * どのキーを書き換えるかは呼び出し側が parse 済みの値 (=== from) で判定する (行置換は値を読まない)。
+ * 対象行が見つからない場合はそのキーを変更しない — 呼び出し側の verifyMemberRename が不一致を検出し
+ * 書込を拒否する (壊れた表記で silent に取りこぼさない)
+ */
+export function replaceMemberKeys(raw, keys, to) {
+    const bom = raw.startsWith('\uFEFF') ? '\uFEFF' : '';
+    const text = bom ? raw.slice(1) : raw;
+    const fm = frontmatterRange(text);
+    if (!fm)
+        return raw;
+    const { lines, close } = fm;
+    for (const key of keys) {
+        for (let i = 1; i < close; i++) {
+            const line = (lines[i] ?? '').replace(/\r$/, '');
+            if (line === `${key}:` || line.startsWith(`${key}: `) || line.startsWith(`${key}:\t`)) {
+                const rendered = `${key}: ${dumpScalar(to)}`;
+                lines[i] = (lines[i] ?? '').endsWith('\r') ? `${rendered}\r` : rendered;
+                break;
+            }
+        }
+    }
+    return bom + lines.join('\n');
+}
+/**
+ * verify-after-member-rename ガード (verifyPinpointResult と同じ思想)。
+ * 「指定キーだけが to に変わり、他フィールドと本文は不変」を patch 前後の再 parse で検証する。
+ * 不一致なら理由文字列 (呼び出し側で書込を拒否)、問題なければ null。
+ */
+export function verifyMemberRename(before, after, keys, to) {
+    const keySet = new Set(keys);
+    for (const key of keys) {
+        if (after.data[key] !== to) {
+            return `行置換が ${key} を正しく書き換えられなかった (この表記はピンポイント書換に未対応)`;
+        }
+    }
+    const allKeys = new Set([...Object.keys(before.data), ...Object.keys(after.data)]);
+    for (const key of allKeys) {
+        if (keySet.has(key))
+            continue;
+        if (!valuesEqual(before.data[key], after.data[key])) {
+            return `行置換が意図しないフィールド ${key} を変更した (この表記はピンポイント書換に未対応)`;
+        }
+    }
+    if (before.body !== after.body) {
+        return '行置換が本文を変更した (この表記はピンポイント書換に未対応)';
+    }
+    return null;
+}
 /**
  * verify-after-patch ガード (PM Round 1 #2/#3/#6 への包括対処)。
  *

package/dist/shared/schema.js

@@ -10,6 +10,8 @@ export const PRIORITIES = ['high', 'medium', 'low'];
 export const MEMBER_TYPES = ['human', 'ai'];
 // マイルストーンの状態 (Phase 2 波 II の新規スキーマ拡張)
 export const MILESTONE_STATUSES = ['planned', 'active', 'done'];
+// UI 表示言語。web の i18n (LANGS) と config.language が共有する唯一の源
+export const UI_LANGS = ['en', 'ja'];
 export const DEFAULT_PORT = 5151;
 /** overview モードの既定ポート (波 VII)。serve の 5151 と衝突しない値・1 箇所集約 */
 export const DEFAULT_OVERVIEW_PORT = 5152;
@@ -26,12 +28,17 @@ export const taskIdSchema = z
 // 1 行テキスト (title 等。改行を含むと行ベースの frontmatter 処理が壊れる)
 const singleLineString = z.string().min(1).regex(/^[^\r\n]+$/, '1 行で書く (改行不可)');
 export const memberSchema = z.object({
+    // スラッグ (タスクファイルの created_by / assignee に書かれる安定 ID)
     id: z.string().min(1),
+    // 表示名 (任意)。未指定は id を表示 (columns label と同じパターン)。表示名の変更は id に影響しない
+    label: z.string().min(1).optional(),
     type: z.enum(MEMBER_TYPES),
 });
 export const columnSchema = z.object({
     id: z.string().min(1),
-    label: z.string().min(1),
+    // 表示名 (任意)。未指定ならビュー層が表示言語に応じた status 訳を出す。
+    // 指定した場合はカスタム名としてどの言語でも最優先で表示される (後方互換)
+    label: z.string().min(1).optional(),
     hideWhenEmpty: z.boolean().optional(),
     wipLimit: z.number().int().positive().optional(),
 });
@@ -65,25 +72,40 @@ export const configSchema = z.object({
         .default('TASK'),
     port: z.number().int().min(1).max(65535).default(DEFAULT_PORT),
     aiTaskCreation: z.enum(['free', 'proposal']).default('free'),
+    // UI 表示言語 (任意)。localStorage は origin (port) 単位で分断されるため、ファイル側を正として言語を運ぶ。
+    // 未指定はクライアント既定 (localStorage → en) に任せる = 既存 config と後方互換
+    language: z.enum(UI_LANGS).optional(),
     members: z
         .array(memberSchema)
         .min(1)
+        // 既定 member はテンプレート (templates/config.json) と同じ汎用名 (公開物に実名を載せない方針)
         .default([
-        { id: 'kurata', type: 'human' },
-        { id: 'fujimaki', type: 'human' },
+        { id: 'member1', type: 'human' },
+        { id: 'member2', type: 'human' },
         { id: 'claude', type: 'ai' },
         { id: 'codex', type: 'ai' },
-    ]),
+    ])
+        // id (スラッグ) はタスク参照の照合キーなので一意必須 (リネーム統合や手編集での重複混入を弾く)
+        .superRefine((members, ctx) => {
+        const seen = new Set();
+        for (const member of members) {
+            if (seen.has(member.id)) {
+                ctx.addIssue({ code: z.ZodIssueCode.custom, message: `member id が重複しています: ${member.id}` });
+            }
+            seen.add(member.id);
+        }
+    }),
+    // 既定カラムは label 無し = UI の表示言語に応じた status 訳で表示する
     columns: z
         .array(columnSchema)
         .min(1)
         .default([
-        { id: 'proposed', label: '提案', hideWhenEmpty: true },
-        { id: 'backlog', label: 'Backlog' },
-        { id: 'todo', label: 'Todo' },
-        { id: 'in_progress', label: 'In Progress', wipLimit: 2 },
-        { id: 'pending', label: 'Pending' },
-        { id: 'done', label: 'Done' },
+        { id: 'proposed', hideWhenEmpty: true },
+        { id: 'backlog' },
+        { id: 'todo' },
+        { id: 'in_progress', wipLimit: 2 },
+        { id: 'pending' },
+        { id: 'done' },
     ]),
     instructionTemplate: z
         .string()
@@ -361,6 +383,17 @@ export const commentInputSchema = z
     .strict();
 /** POST /api/tasks/:id/rename の入力 (重複 ID リネーム支援 F-6-5。空き番号へ採番し直す) */
 export const renameInputSchema = z.object({}).strict();
+/**
+ * POST /api/members/rename の入力 (member スラッグ変更 / 削除時の移譲)。
+ * 全タスクの created_by / assignee の from を to へ付け替える
+ */
+export const memberRenameInputSchema = z
+    .object({
+    from: singleLineString,
+    to: singleLineString,
+})
+    .strict()
+    .refine((v) => v.from !== v.to, { message: 'from と to が同じです' });
 /**
  * 新規タスクの本文テンプレート (要件 §5.3 のファイル例のセクション構成)。
  * HTTP ルート (app.ts) と AI 用 CLI (task-ops.ts) の起票が同じ本文を書くよう、唯一の定義をここに置く。