aizuchi 0.1.0

package/dist/bin/aizuchi.js

@@ -0,0 +1,546 @@
+#!/usr/bin/env node
+import { existsSync, realpathSync, promises as fs } from 'node:fs';
+import path from 'node:path';
+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 { createApp } from '../server/app.js';
+import { 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';
+import { attachStaticAssets } from '../server/static.js';
+import { startWatcher } from '../server/watcher.js';
+/**
+ * AIzuchi CLI (要件 §4.3)。
+ * - init : .kanban/ を生成し、CLAUDE.md へ運用規約をマーカー区切りで追記する (N-9: 冪等)
+ * - serve: 127.0.0.1 限定でボードを起動する (--port > config > 5151)
+ * - overview: 複数 .kanban の read-only 集約を起動する (--port > 5152、波 VII)
+ */
+export const MARKER_BEGIN = '<!-- aizuchi:begin -->';
+export const MARKER_END = '<!-- aizuchi:end -->';
+/** .kanban/ 直下に置く説明ファイル (要件 §4.3 の README) */
+const KANBAN_README = `# .kanban — AIzuchi タスクボード
+
+このディレクトリは AIzuchi (カンバンダッシュボード) のデータ置き場です。
+
+- \`config.json\` — ボード設定 (メンバー・カラム・ID 接頭辞・指示テンプレート)
+- \`tasks/\` — アクティブなタスク (1 タスク = 1 Markdown ファイル、ID = ファイル名)
+- \`archive/\` — 完了・却下タスク (アーカイブ実行月の月別フォルダ)
+
+タスクの書式・運用規約はプロジェクトの CLAUDE.md「AIzuchi 運用規約」を参照してください。
+`;
+/** templates/ を持つパッケージルートを特定する (bin/ と dist/bin/ の両方から動くようにする) */
+export function packageRoot() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (;;) {
+        if (existsSync(path.join(dir, 'templates')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            throw new Error('パッケージルート (templates/ を含むディレクトリ) が見つからない');
+        }
+        dir = parent;
+    }
+}
+/**
+ * メンバー ID の形式 (要件 §5.2 の例に準拠: 英数字・アンダースコア・ハイフン)。
+ * config.json の members.id / created_by / assignee と同じ字種に揃える。
+ */
+export const MEMBER_ID_RE = /^[A-Za-z0-9_-]+$/;
+/** メンバー ID を検証する。不正なら例外 (CLI 引数の早期バリデーション) */
+export function assertValidMemberId(memberId) {
+    if (!MEMBER_ID_RE.test(memberId)) {
+        throw new Error(`--member の ID は英数字・アンダースコア・ハイフンのみ使えます: ${JSON.stringify(memberId)}`);
+    }
+}
+/** テンプレートのメンバー ID 欄を埋める */
+export function renderRulesSection(template, memberId) {
+    // replacement に関数を使う: 文字列だと memberId 中の `$&` 等が置換特殊パターンとして解釈される
+    const body = template.replaceAll('{{MEMBER_ID}}', () => memberId).trimEnd();
+    return `${MARKER_BEGIN}\n${body}\n${MARKER_END}`;
+}
+/**
+ * CLAUDE.md へ規約セクションを適用する (N-9)。
+ * - マーカー区間が既にあれば、その区間だけを置き換える (冪等)
+ * - 無ければ末尾に追記、ファイル自体が無ければ新規内容を返す
+ */
+export function applyRulesSection(existing, section) {
+    if (existing === null) {
+        return `${section}\n`;
+    }
+    const begin = existing.indexOf(MARKER_BEGIN);
+    const end = existing.indexOf(MARKER_END);
+    if (begin !== -1 && end !== -1 && end > begin) {
+        return existing.slice(0, begin) + section + existing.slice(end + MARKER_END.length);
+    }
+    const separator = existing.endsWith('\n\n') ? '' : existing.endsWith('\n') ? '\n' : '\n\n';
+    return `${existing}${separator}${section}\n`;
+}
+export async function runInit(options) {
+    const cwd = path.resolve(options.cwd);
+    const memberId = options.memberId ?? 'claude';
+    assertValidMemberId(memberId);
+    const log = options.log ?? ((line) => console.log(line));
+    const confirm = options.confirm ?? (async () => true);
+    const kanbanDir = path.join(cwd, '.kanban');
+    if (existsSync(kanbanDir)) {
+        // 既存データを壊さないため中断する (要件 §4.3)。既存ファイルには一切触れない
+        throw new Error('.kanban/ が既に存在するため中断しました。再セットアップする場合は .kanban/ を退避してください');
+    }
+    // 1. .kanban/ 一式の生成
+    await fs.mkdir(path.join(kanbanDir, 'tasks'), { recursive: true });
+    await fs.mkdir(path.join(kanbanDir, 'archive'), { recursive: true });
+    const templateRaw = await fs.readFile(path.join(packageRoot(), 'templates', 'config.json'), 'utf8');
+    const config = JSON.parse(templateRaw);
+    config.projectName = path.basename(cwd);
+    // --member の ID を config.members へ ai 種別で登録する (要件 §8)。さもないと AI が自分の ID で
+    // 起票した瞬間「members 未登録」警告に落ち、AI 連携の入口が壊れる (R3-5)
+    const members = Array.isArray(config.members) ? config.members : [];
+    if (!members.some((m) => m.id === memberId)) {
+        members.push({ id: memberId, type: 'ai' });
+        config.members = members;
+        log(`メンバー "${memberId}" (ai) を config.members に追加しました`);
+    }
+    await writeFileAtomic(path.join(kanbanDir, 'config.json'), `${JSON.stringify(config, null, 2)}\n`);
+    await writeFileAtomic(path.join(kanbanDir, 'README.md'), KANBAN_README);
+    log(`.kanban/ を生成しました (project: ${String(config.projectName)})`);
+    // 2. CLAUDE.md への運用規約追記 (マーカー区切り・diff 提示 + 確認)
+    const rulesTemplate = await fs.readFile(path.join(packageRoot(), 'templates', 'claude-rules.md'), 'utf8');
+    const section = renderRulesSection(rulesTemplate, memberId);
+    const claudeMdPath = path.join(cwd, 'CLAUDE.md');
+    const existing = existsSync(claudeMdPath) ? await fs.readFile(claudeMdPath, 'utf8') : null;
+    const next = applyRulesSection(existing, section);
+    let claudeMdUpdated = false;
+    if (next === existing) {
+        log('CLAUDE.md は既に最新の運用規約を含んでいます (変更なし)');
+    }
+    else {
+        const action = existing === null
+            ? 'CLAUDE.md を新規作成し、運用規約セクションを書き込みます'
+            : existing.includes(MARKER_BEGIN)
+                ? 'CLAUDE.md のマーカー区間 (aizuchi:begin〜end) だけを置き換えます'
+                : 'CLAUDE.md の末尾に運用規約セクションを追記します';
+        const preview = [`${action}:`, '--- 追記/置換されるセクション ---', section, '--- ここまで ---'].join('\n');
+        if (await confirm(preview)) {
+            await writeFileAtomic(claudeMdPath, next);
+            claudeMdUpdated = true;
+            log(`CLAUDE.md を更新しました (メンバー ID: ${memberId})`);
+        }
+        else {
+            log('CLAUDE.md の更新をスキップしました (.kanban/ は生成済み)');
+        }
+    }
+    log('完了。`npx aizuchi` でボードを起動できます');
+    return { kanbanCreated: true, claudeMdUpdated };
+}
+export async function runServe(options) {
+    const cwd = path.resolve(options.cwd);
+    const log = options.log ?? ((line) => console.log(line));
+    const kanbanDir = path.join(cwd, '.kanban');
+    if (!existsSync(kanbanDir)) {
+        throw new Error('.kanban/ が見つかりません。先に `npx aizuchi init` を実行してください');
+    }
+    // クラッシュ時の一時ファイル残骸を清掃する (R17-D: .kanban の realpath 信頼境界内に限定削除)。
+    // .kanban が symlink 等で realpath 確立に失敗したら cleanup を skip する (任意ファイル削除の防止)
+    try {
+        const kanbanReal = await resolveKanbanReal(cwd);
+        const removed = await cleanupStaleTmpFiles(kanbanReal, kanbanReal);
+        if (removed > 0) {
+            log(`一時ファイルの残骸を ${removed} 件清掃しました`);
+        }
+    }
+    catch {
+        // .kanban が symlink / 不在: cleanup を skip (containment 外の削除はしない)
+    }
+    const { config } = await loadConfig(cwd);
+    const port = options.port ?? config.port ?? DEFAULT_PORT;
+    const bus = createEventBus();
+    const { app } = createApp({ projectRoot: cwd, bus });
+    attachStaticAssets(app, path.join(packageRoot(), 'dist', 'web'));
+    const watcher = startWatcher({ kanbanDir, bus });
+    const { server, boundPort } = await new Promise((resolve, reject) => {
+        // 127.0.0.1 限定でバインドする (N-1)。0.0.0.0 や LAN IP への変更手段は提供しない。
+        // info.port は実際にバインドされたポート (port=0 のときは OS が選んだ番号が入る)
+        const created = serve({ fetch: app.fetch, port, hostname: '127.0.0.1' }, (info) => resolve({ server: created, boundPort: info.port }));
+        created.on('error', (error) => {
+            if (error.code === 'EADDRINUSE') {
+                // 自動でポートを変えず、明確なエラーで終了する (決定済み)
+                reject(new Error(`ポート ${port} は使用中です。--port <番号> か .kanban/config.json の port で変更してください`));
+            }
+            else {
+                reject(error);
+            }
+        });
+    }).catch(async (error) => {
+        await watcher.close();
+        throw error;
+    });
+    log(`AIzuchi: http://127.0.0.1:${boundPort} (project: ${config.projectName})`);
+    log('終了するには Ctrl+C');
+    return {
+        port: boundPort,
+        async close() {
+            await watcher.close();
+            // 活きた SSE 接続 (GET /api/events) があると server.close() の callback が永久に呼ばれない
+            // (http.Server.close は全接続が閉じるまで待つ)。先に全接続を強制クローズしてから close する
+            // (Node 18.2+ の closeAllConnections。M4 で EventSource が常時 1 本開くため必須)。
+            // @hono/node-server の ServerType union には型が無いため http.Server として参照する
+            const closable = server;
+            closable.closeAllConnections?.();
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// overview モード (波 VII): 複数 .kanban の read-only 集約
+// ---------------------------------------------------------------------------
+/**
+ * overview の対象ディレクトリを検証して realpath の配列を返す。
+ * 各 dir: 正規化 + realpath 解決 → <dir>/.kanban の存在を検証。
+ * 無い dir は明確なエラーで起動拒否 (typo の silent skip は混乱の元・fail-fast)。0 件は usage エラー。
+ * R12-1: 同一 realpath の重複指定 (相対/絶対・末尾スラッシュ・symlink 別名) も明確なエラーで拒否する
+ * (silent 排除だと「2 件指定したのに 1 枚」の混乱、放置だとカード偽装 + 二重計上 + watcher 二重)。
+ */
+export function resolveOverviewRoots(dirs) {
+    if (dirs.length === 0) {
+        throw new Error('使い方: aizuchi overview <dir...> [--port <番号>] (対象ディレクトリを 1 つ以上指定してください)');
+    }
+    const seen = new Map(); // realpath → 最初に指定された表記
+    return dirs.map((dir) => {
+        const resolved = path.resolve(dir);
+        let real;
+        try {
+            real = realpathSync(resolved);
+        }
+        catch {
+            throw new Error(`ディレクトリが存在しません: ${dir}`);
+        }
+        if (!existsSync(path.join(real, '.kanban'))) {
+            throw new Error(`.kanban/ が見つかりません: ${dir} (aizuchi init 済みのプロジェクトを指定してください)`);
+        }
+        const first = seen.get(real);
+        if (first !== undefined) {
+            throw new Error(`同じディレクトリが重複指定されています: ${first} と ${dir} (実体: ${real})`);
+        }
+        seen.set(real, dir);
+        return real;
+    });
+}
+/**
+ * overview の引数解析 (R12-2)。位置引数 (dir...) + --port のみを受け付け、
+ * 不明なオプション / フラグは fail-fast で拒否する (typo の silent 無視や
+ * `--foo ./b` が ./b を値として飲み込み監視対象が黙って脱落する事故を防ぐ)。
+ */
+export function parseOverviewArgs(args) {
+    const { positional, opts, flags } = parseTaskArgs(args);
+    for (const key of opts.keys()) {
+        if (key !== 'port') {
+            throw new Error(`不明な引数: --${key} (overview は <dir...> と --port のみ受け付けます)`);
+        }
+    }
+    const unknownFlag = [...flags][0];
+    if (unknownFlag !== undefined) {
+        throw new Error(`不明な引数: --${unknownFlag} (overview は <dir...> と --port のみ受け付けます)`);
+    }
+    let port;
+    const portValue = opts.get('port');
+    if (portValue !== undefined) {
+        port = Number.parseInt(portValue, 10);
+        if (!Number.isInteger(port) || port < 1 || port > 65535) {
+            throw new Error('--port には 1〜65535 の整数を指定してください');
+        }
+    }
+    return { dirs: positional, port };
+}
+export async function runOverview(options) {
+    const log = options.log ?? ((line) => console.log(line));
+    const roots = resolveOverviewRoots(options.dirs);
+    const port = options.port ?? DEFAULT_OVERVIEW_PORT;
+    const bus = createEventBus();
+    const { app } = createOverviewApp({ projectRoots: roots, bus });
+    attachStaticAssets(app, path.join(packageRoot(), 'dist', 'web'));
+    // ルートごとに watcher を起動し共有 bus へ notify (SSE → クライアントは /api/overview を全量再取得)
+    const watchers = roots.map((root) => startWatcher({ kanbanDir: path.join(root, '.kanban'), bus }));
+    const { server, boundPort } = await new Promise((resolve, reject) => {
+        // 127.0.0.1 限定でバインドする (N-1)。serve と同じ起動コード
+        const created = serve({ fetch: app.fetch, port, hostname: '127.0.0.1' }, (info) => resolve({ server: created, boundPort: info.port }));
+        created.on('error', (error) => {
+            if (error.code === 'EADDRINUSE') {
+                reject(new Error(`ポート ${port} は使用中です。--port <番号> で変更してください`));
+            }
+            else {
+                reject(error);
+            }
+        });
+    }).catch(async (error) => {
+        await Promise.all(watchers.map((w) => w.close()));
+        throw error;
+    });
+    log(`AIzuchi overview: http://127.0.0.1:${boundPort} (${roots.length} project(s))`);
+    log('終了するには Ctrl+C');
+    return {
+        port: boundPort,
+        async close() {
+            // 全 watcher close + SSE 接続の強制クローズ (runServe と同じ理由)
+            await Promise.all(watchers.map((w) => w.close()));
+            const closable = server;
+            closable.closeAllConnections?.();
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+    };
+}
+function parseArgs(argv) {
+    const args = [...argv];
+    let command = 'serve';
+    if (args[0] !== undefined && !args[0].startsWith('-')) {
+        command = args.shift();
+    }
+    let port;
+    let memberId;
+    let yes = false;
+    while (args.length > 0) {
+        const arg = args.shift();
+        if (arg === '--port') {
+            port = Number.parseInt(args.shift() ?? '', 10);
+        }
+        else if (arg.startsWith('--port=')) {
+            port = Number.parseInt(arg.slice('--port='.length), 10);
+        }
+        else if (arg === '--member') {
+            memberId = args.shift();
+        }
+        else if (arg.startsWith('--member=')) {
+            memberId = arg.slice('--member='.length);
+        }
+        else if (arg === '--yes' || arg === '-y') {
+            yes = true;
+        }
+        else {
+            throw new Error(`不明な引数: ${arg}`);
+        }
+    }
+    if (port !== undefined && (!Number.isInteger(port) || port < 1 || port > 65535)) {
+        throw new Error('--port には 1〜65535 の整数を指定してください');
+    }
+    return { command, port, memberId, yes };
+}
+/** 対話確認 (TTY のみ。--yes か非対話環境では確認を省略する) */
+async function promptConfirm(message) {
+    console.log(message);
+    if (!process.stdin.isTTY) {
+        console.log('(非対話環境のため確認を省略して続行します)');
+        return true;
+    }
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = await new Promise((resolve) => {
+            rl.question('CLAUDE.md を更新しますか? [Y/n] ', resolve);
+        });
+        return answer.trim() === '' || /^y(es)?$/i.test(answer.trim());
+    }
+    finally {
+        rl.close();
+    }
+}
+// ---------------------------------------------------------------------------
+// AI 用 CLI (F-6-3): task add/move/log/comment/done/block
+// ---------------------------------------------------------------------------
+/** 値を取らない真の flag (それ以外の `--key` は値必須として扱う)。`--json` のみ */
+const TASK_BARE_FLAGS = new Set(['json']);
+/** `--key value` / `--key=value` / `--flag` を解析する簡易パーサ (positional は順に取り出す) */
+function parseTaskArgs(args) {
+    const positional = [];
+    const opts = new Map();
+    const flags = new Set();
+    const rest = [...args];
+    while (rest.length > 0) {
+        const arg = rest.shift();
+        if (arg.startsWith('--')) {
+            const eq = arg.indexOf('=');
+            if (eq !== -1) {
+                // `--key=value` は値が `--` で始まっても明示指定として受け取る (取りこぼし回避の唯一の経路)
+                opts.set(arg.slice(2, eq), arg.slice(eq + 1));
+            }
+            else {
+                const key = arg.slice(2);
+                if (TASK_BARE_FLAGS.has(key)) {
+                    flags.add(key);
+                }
+                else {
+                    // 値を取るオプション。次トークンが `--` 始まり (別オプション) だと、以前は黙って flag 扱いに
+                    // なり値を取りこぼしていた。明示エラーにして、`--key=--value` 形式を使うよう促す
+                    const next = rest[0];
+                    if (next === undefined || next.startsWith('--')) {
+                        throw new Error(`--${key} には値が必要です (値が "--" で始まる場合は --${key}=<値> 形式で指定してください)`);
+                    }
+                    opts.set(key, rest.shift());
+                }
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, opts, flags };
+}
+/** cwd (または --cwd) から上方向に .kanban を探してプロジェクトルートを返す。無ければ throw */
+async function resolveProjectRoot(startDir) {
+    let dir = path.resolve(startDir);
+    for (;;) {
+        if (existsSync(path.join(dir, '.kanban')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            throw new Error('.kanban/ が見つかりません (aizuchi init を実行したディレクトリで実行してください)');
+        }
+        dir = parent;
+    }
+}
+/**
+ * `task` サブコマンドを実行する。出力は人間可読 + `--json` で機械可読。
+ * 既存の TaskOps (schema 検証・採番直列化・pinpoint+verify・パス検証) を呼ぶだけの薄いラッパー。
+ * 戻り値は exit code (0 = 成功 / 1 = 入力エラー / 2 = not found / 3 = conflict)。
+ */
+export async function runTaskCli(argv, io = {
+    out: (s) => console.log(s),
+    err: (s) => console.error(s),
+}) {
+    const { TaskOps, TaskOpError } = await import('../server/lib/task-ops.js');
+    const sub = argv[0];
+    // 引数解析エラー (値の取りこぼし等) も catch で exit 1 + io.err に倒すため try 内で解析する。
+    // json は catch でも使うので false で初期化し、解析後に確定する
+    let json = false;
+    const splitLabels = (v) => v === undefined ? undefined : v.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
+    try {
+        const { positional, opts, flags } = parseTaskArgs(argv.slice(1));
+        json = flags.has('json');
+        const root = await resolveProjectRoot(opts.get('cwd') ?? process.cwd());
+        const ops = new TaskOps(root);
+        const emit = (view, human) => {
+            if (json)
+                io.out(JSON.stringify(view));
+            else
+                io.out(human);
+            return 0;
+        };
+        switch (sub) {
+            case 'add': {
+                const view = await ops.create({
+                    title: opts.get('title') ?? '',
+                    created_by: opts.get('created-by') ?? 'claude',
+                    status: opts.get('status'),
+                    assignee: opts.get('assignee') ?? null,
+                    priority: opts.get('priority'),
+                    labels: splitLabels(opts.get('labels')),
+                });
+                return emit(view, `起票: ${view.frontmatter.id} (${view.frontmatter.status}) ${view.frontmatter.title}`);
+            }
+            case 'move': {
+                const view = await ops.move(positional[0] ?? '', {
+                    status: positional[1],
+                    blocked_type: opts.get('blocked-type'),
+                    blocked_reason: opts.get('blocked-reason') ?? undefined,
+                });
+                return emit(view, `移動: ${view.frontmatter.id} → ${view.frontmatter.status}`);
+            }
+            case 'done': {
+                const view = await ops.move(positional[0] ?? '', { status: 'done' });
+                return emit(view, `完了: ${view.frontmatter.id}`);
+            }
+            case 'block': {
+                const view = await ops.move(positional[0] ?? '', {
+                    status: 'pending',
+                    blocked_type: opts.get('type'),
+                    blocked_reason: opts.get('reason') ?? undefined,
+                });
+                return emit(view, `保留: ${view.frontmatter.id} (${view.frontmatter.blocked_type ?? ''})`);
+            }
+            case 'log': {
+                const view = await ops.appendLog(positional[0] ?? '', opts.get('member') ?? 'claude', positional[1] ?? '');
+                return emit(view, `作業ログ追記: ${view.frontmatter.id}`);
+            }
+            case 'comment': {
+                const view = await ops.appendComment(positional[0] ?? '', opts.get('member') ?? 'claude', positional[1] ?? '');
+                return emit(view, `コメント追記: ${view.frontmatter.id}`);
+            }
+            default:
+                io.err('task サブコマンド: add / move <id> <status> / done <id> / block <id> --type --reason / log <id> "msg" / comment <id> "msg"');
+                return 1;
+        }
+    }
+    catch (error) {
+        if (error instanceof TaskOpError) {
+            const body = json
+                ? JSON.stringify({ error: error.message, code: error.code, ...(error.issues ? { issues: error.issues } : {}) })
+                : `${error.message}${error.issues ? `\n  - ${error.issues.join('\n  - ')}` : ''}`;
+            io.err(body);
+            // code → exit code (N-8: メッセージにファイル本文を含めない)
+            return error.code === 'not_found' ? 2 : error.code === 'conflict' ? 3 : 1;
+        }
+        io.err(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+}
+async function main() {
+    try {
+        const rawArgs = process.argv.slice(2);
+        // task サブコマンドは独自パーサ (init/serve のフラグ解析とは別系統)
+        if (rawArgs[0] === 'task') {
+            process.exitCode = await runTaskCli(rawArgs.slice(1));
+            return;
+        }
+        // overview サブコマンド (波 VII): 位置引数 (dir...) + --port のみ。不明な引数は fail-fast (R12-2)
+        if (rawArgs[0] === 'overview') {
+            const { dirs, port } = parseOverviewArgs(rawArgs.slice(1));
+            const running = await runOverview({ dirs, port });
+            const shutdown = () => {
+                void running.close().then(() => process.exit(0));
+            };
+            process.on('SIGINT', shutdown);
+            process.on('SIGTERM', shutdown);
+            return;
+        }
+        const { command, port, memberId, yes } = parseArgs(rawArgs);
+        if (command === 'init') {
+            await runInit({
+                cwd: process.cwd(),
+                memberId,
+                confirm: yes ? async () => true : promptConfirm,
+            });
+        }
+        else if (command === 'serve') {
+            const running = await runServe({ cwd: process.cwd(), port });
+            const shutdown = () => {
+                void running.close().then(() => process.exit(0));
+            };
+            process.on('SIGINT', shutdown);
+            process.on('SIGTERM', shutdown);
+        }
+        else {
+            console.error(`不明なコマンド: ${command}\n` +
+                '使い方: aizuchi [init|serve|task] [--port <番号>] [--member <ID>] [--yes]\n' +
+                `       aizuchi overview <dir...> [--port <番号>]  (複数 .kanban の read-only 集約・既定ポート ${DEFAULT_OVERVIEW_PORT})`);
+            process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    }
+}
+/** ESM entry gate (LEARN#14): テストが import した時は main を実行しない */
+function isEntry() {
+    if (!process.argv[1])
+        return false;
+    try {
+        return import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntry()) {
+    void main();
+}