throughline 0.2.0 → 0.3.1

package/src/state-file.mjs

@@ -68,25 +68,52 @@ export const STALE_DELETE_MS = 24 * 60 * 60 * 1000; // 24 時間: ファイル
 export function readAllSessionStates() {
   if (!existsSync(STATE_DIR)) return [];
   const now = Date.now();
-  const entries = readdirSync(STATE_DIR);
+  let entries;
+  try {
+    entries = readdirSync(STATE_DIR);
+  } catch (err) {
+    if (err.code === 'ENOENT') return [];
+    process.stderr.write(`[state-file] readdir failed (${err.code ?? 'unknown'}): ${err.message}\n`);
+    return [];
+  }
   const results = [];
   for (const name of entries) {
     if (!name.endsWith('.json')) continue;
     const file = join(STATE_DIR, name);
-    const raw = readFileSync(file, 'utf8');
+
+    // 常駐 monitor を落とさないため IO 例外は吸収する。
+    // ENOENT: 削除 race、EACCES/EPERM: 一時的権限問題、いずれも skip して次フレームで再試行
+    let raw;
+    try {
+      raw = readFileSync(file, 'utf8');
+    } catch (err) {
+      if (err.code !== 'ENOENT') {
+        process.stderr.write(`[state-file] read failed ${name} (${err.code ?? 'unknown'}): ${err.message}\n`);
+      }
+      continue;
+    }
+
     let parsed;
     try {
       parsed = JSON.parse(raw);
     } catch (err) {
       // JSON 破損は状態ファイル固有の冪等な状況（次ターンで再生成される）
       process.stderr.write(`[state-file] corrupt state file ${name}, deleting: ${err.message}\n`);
-      unlinkSync(file);
+      try {
+        unlinkSync(file);
+      } catch {
+        // 削除失敗も握りつぶす（次回削除される）
+      }
       continue;
     }
     const age = now - (parsed.updatedAt ?? 0);
     if (age > STALE_DELETE_MS) {
       // 24h 超: ハード削除（無制限蓄積防止）
-      unlinkSync(file);
+      try {
+        unlinkSync(file);
+      } catch {
+        // 削除失敗は致命ではない、次回再試行
+      }
       continue;
     }
     parsed.stale = age > STALE_HIDE_MS;
@@ -102,15 +129,25 @@ export function readAllSessionStates() {
 export function snapshotStateMtimes() {
   const result = new Map();
   if (!existsSync(STATE_DIR)) return result;
-  for (const name of readdirSync(STATE_DIR)) {
+  let entries;
+  try {
+    entries = readdirSync(STATE_DIR);
+  } catch (err) {
+    if (err.code === 'ENOENT') return result;
+    process.stderr.write(`[state-file] snapshot readdir failed (${err.code ?? 'unknown'}): ${err.message}\n`);
+    return result;
+  }
+  for (const name of entries) {
     if (!name.endsWith('.json')) continue;
     // readdir と stat の間でファイルが削除される race がある。
-    // ENOENT のみ許容してそれ以外は throw（§0）
+    // monitor を落とさないため ENOENT 以外の IO 例外も吸収する（EACCES/EPERM 等は一時的で次フレームで回復）
     const file = join(STATE_DIR, name);
     try {
       result.set(name, statSync(file).mtimeMs);
     } catch (err) {
-      if (err.code !== 'ENOENT') throw err;
+      if (err.code !== 'ENOENT') {
+        process.stderr.write(`[state-file] stat failed ${name} (${err.code ?? 'unknown'}): ${err.message}\n`);
+      }
     }
   }
   return result;

package/src/state-file.test.mjs

@@ -0,0 +1,135 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, writeFileSync, rmSync, mkdirSync, chmodSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir, homedir, platform } from 'node:os';
+
+import { normalizeProjectPath } from './state-file.mjs';
+
+// state-file.mjs は ~/.throughline/state を直接見るので、モジュール全体を一時ディレクトリ指定で
+// 差し替える薄いヘルパーを用意する。HOME 環境変数を偽装して import し直す方式で隔離する。
+async function withIsolatedStateDir(testFn) {
+  const work = mkdtempSync(join(tmpdir(), 'tl-state-'));
+  const origHome = process.env.HOME;
+  const origUserProfile = process.env.USERPROFILE;
+  process.env.HOME = work;
+  process.env.USERPROFILE = work;
+  // ESM キャッシュをバイパスするため query string 付きで import
+  const mod = await import(`./state-file.mjs?isolated=${Date.now()}-${Math.random()}`);
+  const stateDir = mod.getStateDir();
+  mkdirSync(stateDir, { recursive: true });
+  try {
+    await testFn({ stateDir, mod });
+  } finally {
+    process.env.HOME = origHome;
+    process.env.USERPROFILE = origUserProfile;
+    rmSync(work, { recursive: true, force: true });
+  }
+}
+
+test('normalizeProjectPath: 空文字列は空文字列', () => {
+  assert.equal(normalizeProjectPath(''), '');
+  assert.equal(normalizeProjectPath(null), '');
+  assert.equal(normalizeProjectPath(undefined), '');
+});
+
+test('normalizeProjectPath: バックスラッシュがスラッシュになり末尾スラッシュ除去', () => {
+  const result = normalizeProjectPath('C:\\Users\\foo\\');
+  assert.ok(result.includes('/'));
+  assert.ok(!result.endsWith('/') || result === '/');
+});
+
+test('normalizeProjectPath: Windows では lowercase', () => {
+  if (platform() !== 'win32') return;
+  const result = normalizeProjectPath('C:\\Users\\Foo');
+  assert.equal(result, result.toLowerCase());
+});
+
+test('readAllSessionStates: 破損 JSON を削除して skip する', async () => {
+  await withIsolatedStateDir(async ({ stateDir, mod }) => {
+    const broken = join(stateDir, 'broken-abc.json');
+    const good = join(stateDir, 'good-session.json');
+    writeFileSync(broken, '{ not valid json');
+    writeFileSync(good, JSON.stringify({
+      sessionId: 'good-session',
+      projectPath: '/tmp/foo',
+      transcriptPath: null,
+      updatedAt: Date.now(),
+    }));
+    const results = mod.readAllSessionStates();
+    assert.equal(results.length, 1);
+    assert.equal(results[0].sessionId, 'good-session');
+    // 破損ファイルは削除されている
+    assert.ok(!existsSync(broken), 'corrupt file should be unlinked');
+  });
+});
+
+test('readAllSessionStates: 24h 超のファイルはハード削除される', async () => {
+  await withIsolatedStateDir(async ({ stateDir, mod }) => {
+    const old = join(stateDir, 'old-session.json');
+    const past = Date.now() - (25 * 60 * 60 * 1000); // 25h 前
+    writeFileSync(old, JSON.stringify({
+      sessionId: 'old-session',
+      projectPath: '/tmp/foo',
+      transcriptPath: null,
+      updatedAt: past,
+    }));
+    const results = mod.readAllSessionStates();
+    assert.equal(results.length, 0);
+    assert.ok(!existsSync(old), 'old file should be deleted');
+  });
+});
+
+test('readAllSessionStates: 15 分超は stale フラグ付きで返される', async () => {
+  await withIsolatedStateDir(async ({ stateDir, mod }) => {
+    const stale = join(stateDir, 'stale-session.json');
+    const past = Date.now() - (20 * 60 * 1000); // 20 分前
+    writeFileSync(stale, JSON.stringify({
+      sessionId: 'stale-session',
+      projectPath: '/tmp/foo',
+      transcriptPath: null,
+      updatedAt: past,
+    }));
+    const results = mod.readAllSessionStates();
+    assert.equal(results.length, 1);
+    assert.equal(results[0].stale, true);
+  });
+});
+
+test('readAllSessionStates: state ディレクトリ未作成なら空配列', async () => {
+  await withIsolatedStateDir(async ({ stateDir, mod }) => {
+    rmSync(stateDir, { recursive: true, force: true });
+    const results = mod.readAllSessionStates();
+    assert.deepEqual(results, []);
+  });
+});
+
+test('snapshotStateMtimes: 存在する JSON の mtime を返す', async () => {
+  await withIsolatedStateDir(async ({ stateDir, mod }) => {
+    const file = join(stateDir, 'abc.json');
+    writeFileSync(file, '{}');
+    const snap = mod.snapshotStateMtimes();
+    assert.equal(snap.size, 1);
+    assert.ok(snap.has('abc.json'));
+    assert.ok(typeof snap.get('abc.json') === 'number');
+  });
+});
+
+test('snapshotStateMtimes: .json 以外は無視', async () => {
+  await withIsolatedStateDir(async ({ stateDir, mod }) => {
+    writeFileSync(join(stateDir, 'ignored.txt'), 'hello');
+    writeFileSync(join(stateDir, 'abc.json'), '{}');
+    const snap = mod.snapshotStateMtimes();
+    assert.equal(snap.size, 1);
+    assert.ok(snap.has('abc.json'));
+    assert.ok(!snap.has('ignored.txt'));
+  });
+});
+
+test('snapshotStateMtimes: ディレクトリ未作成なら空 Map', async () => {
+  await withIsolatedStateDir(async ({ stateDir, mod }) => {
+    rmSync(stateDir, { recursive: true, force: true });
+    const snap = mod.snapshotStateMtimes();
+    assert.equal(snap.size, 0);
+  });
+});

package/src/token-monitor.mjs

@@ -18,9 +18,10 @@
  */
 
 import { basename } from 'node:path';
+import { stripVTControlCharacters } from 'node:util';
+import { statSync, existsSync } from 'node:fs';
 import { getStateDir, readAllSessionStates, snapshotStateMtimes, normalizeProjectPath } from './state-file.mjs';
 import { readLatestUsage } from './transcript-usage.mjs';
-import { stripAnsi } from './transcript-reader.mjs';
 
 const REFRESH_MS = 1000;
 
@@ -45,60 +46,156 @@ function color(c, text) {
   return `${c}${text}${ANSI.reset}`;
 }
 
-/** ANSI エスケープシーケンスを除いた可視文字数を返す（サロゲートペア考慮はしない簡易版） */
-function visibleLength(s) {
-  return stripAnsi(s).length;
+// --- セル幅計算（ANSI / CJK / 絵文字対応、依存ゼロ） ---
+//
+// Node v22 には util.getStringWidth がないため、主要な East Asian Wide + 絵文字ブロックを
+// 自前の範囲判定で 2 セルとして扱う。East Asian Ambiguous は 1 セル（アラビア・タイ等は
+// 既存の char-count 実装と同じ扱いなので悪化しない）。
+// ZWJ / VS16 は幅 0 として扱う（絵文字シーケンスの微ズレは許容）。
+const ZERO_WIDTH_CODEPOINTS = new Set([0x200b, 0x200c, 0x200d, 0xfeff, 0xfe0e, 0xfe0f]);
+
+/**
+ * 単一コードポイントのセル幅を返す（0 / 1 / 2）
+ * @param {number} cp
+ */
+function codePointWidth(cp) {
+  if (cp < 0x20) return 0;                          // C0 制御
+  if (cp >= 0x7f && cp < 0xa0) return 0;            // DEL / C1 制御
+  if (ZERO_WIDTH_CODEPOINTS.has(cp)) return 0;
+  // Combining marks (簡易: Combining Diacritical Marks 主要ブロック)
+  if (cp >= 0x0300 && cp <= 0x036f) return 0;
+  // Wide ranges
+  if (
+    (cp >= 0x1100 && cp <= 0x115f) ||               // Hangul Jamo
+    (cp >= 0x2e80 && cp <= 0x303e) ||               // CJK Radicals / Kangxi
+    (cp >= 0x3041 && cp <= 0x33ff) ||               // Hiragana/Katakana/Bopomofo/CJK Symbols
+    (cp >= 0x3400 && cp <= 0x4dbf) ||               // CJK Ext A
+    (cp >= 0x4e00 && cp <= 0x9fff) ||               // CJK Unified
+    (cp >= 0xa000 && cp <= 0xa4cf) ||               // Yi
+    (cp >= 0xac00 && cp <= 0xd7a3) ||               // Hangul Syllables
+    (cp >= 0xf900 && cp <= 0xfaff) ||               // CJK Compat Ideographs
+    (cp >= 0xfe30 && cp <= 0xfe4f) ||               // CJK Compat Forms
+    (cp >= 0xff00 && cp <= 0xff60) ||               // Fullwidth
+    (cp >= 0xffe0 && cp <= 0xffe6) ||               // Fullwidth signs
+    (cp >= 0x1f300 && cp <= 0x1faff) ||             // 絵文字主要ブロック
+    (cp >= 0x20000 && cp <= 0x3134f)                // CJK Ext B-G
+  ) {
+    return 2;
+  }
+  return 1;
 }
 
 /**
- * 行をターミナル幅に収まるよう切り詰める。ANSI コードを壊さないため、
- * 可視文字だけを数えながらコピーし、上限に達したら reset を付けて返す。
+ * 文字列のセル幅合計（ANSI 剥ぎ取り済み前提ではない — 内部で剥ぐ）
+ * @param {string} s
+ */
+function cellWidth(s) {
+  if (typeof s !== 'string') return 0;
+  const stripped = stripVTControlCharacters(s);
+  let total = 0;
+  for (const ch of stripped) {
+    total += codePointWidth(ch.codePointAt(0));
+  }
+  return total;
+}
+
+/**
+ * 行をセル幅で切り詰める。ANSI コードはそのまま通過させ（幅 0）、
+ * 可視セル幅が maxCells に達したら残りを捨てて reset を付けて返す。
+ * CJK 文字を跨ぐときは 1 セル余る場合があるので空白で埋める。
  * @param {string} line
- * @param {number} maxWidth
+ * @param {number} maxCells
  */
-function truncateToWidth(line, maxWidth) {
-  if (maxWidth <= 0) return '';
-  if (visibleLength(line) <= maxWidth) return line;
+function truncateToCells(line, maxCells) {
+  if (maxCells <= 0) return '';
+  if (cellWidth(line) <= maxCells) return line;
   let out = '';
-  let visible = 0;
+  let cells = 0;
   let i = 0;
-  while (i < line.length && visible < maxWidth) {
-    const ch = line[i];
-    if (ch === '\x1b' && line[i + 1] === '[') {
-      // ANSI sequence: copy until final byte (a-zA-Z)
-      const end = line.slice(i).search(/[a-zA-Z]/);
-      if (end === -1) break;
-      out += line.slice(i, i + end + 1);
-      i += end + 1;
+  while (i < line.length) {
+    const code = line.charCodeAt(i);
+    // ANSI CSI: \x1b[ ... 終端 (0x40-0x7e)
+    if (code === 0x1b && line.charCodeAt(i + 1) === 0x5b) {
+      let j = i + 2;
+      while (j < line.length) {
+        const c = line.charCodeAt(j);
+        if (c >= 0x40 && c <= 0x7e) { j++; break; }
+        j++;
+      }
+      out += line.slice(i, j);
+      i = j;
       continue;
     }
+    // コードポイント単位で取得（サロゲートペア考慮）
+    const cp = line.codePointAt(i);
+    const ch = String.fromCodePoint(cp);
+    const w = codePointWidth(cp);
+    if (cells + w > maxCells) {
+      // CJK 1 セル余り
+      if (cells < maxCells) out += ' ';
+      break;
+    }
     out += ch;
-    visible++;
-    i++;
+    cells += w;
+    i += ch.length;
   }
   return out + ANSI.reset;
 }
 
+/**
+ * 文字列の末尾を半角スペースでパディングして targetCells に揃える。
+ * 既にはみ出している場合は truncateToCells で切り詰める。
+ * @param {string} s
+ * @param {number} targetCells
+ */
+function padCellsEnd(s, targetCells) {
+  const width = cellWidth(s);
+  if (width === targetCells) return s;
+  if (width > targetCells) return truncateToCells(s, targetCells);
+  return s + ' '.repeat(targetCells - width);
+}
+
 // --- CLI 引数 ---
+/**
+ * @param {string[]} argv
+ * @returns {{all: boolean, session: string|null}}
+ * @throws {Error} --session に値が欠落している場合
+ */
 function parseArgs(argv) {
   const args = { all: false, session: null };
   for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === '--all') args.all = true;
-    else if (argv[i] === '--session') args.session = argv[++i];
+    if (argv[i] === '--all') {
+      args.all = true;
+    } else if (argv[i] === '--session') {
+      const value = argv[i + 1];
+      if (value === undefined || value.startsWith('--')) {
+        throw new Error('--session requires a session id (or prefix) as next argument');
+      }
+      args.session = value;
+      i++;
+    }
   }
   return args;
 }
 
 // --- 表示 ---
 function renderBar(ratio, width = 20) {
-  const filled = Math.max(0, Math.min(width, Math.round(ratio * width)));
+  // NaN は 0、+Infinity は 1（オーバーフロー = 満タン表示）、負値 / -Infinity は 0 にクランプ
+  let safe;
+  if (Number.isNaN(ratio)) safe = 0;
+  else if (ratio === Infinity) safe = 1;
+  else if (ratio === -Infinity) safe = 0;
+  else safe = Math.max(0, Math.min(1, ratio));
+  const filled = Math.round(safe * width);
   return '█'.repeat(filled) + '░'.repeat(width - filled);
 }
 
 function formatNumber(n) {
-  if (n >= 1_000_000) return (n / 1_000_000).toFixed(2) + 'M';
+  if (!Number.isFinite(n) || n < 0) return '0';
+  // 999_950 以上は toFixed(1) で "1000.0k" になってしまうので M 表記に切り上げる
+  if (n >= 999_500) return (n / 1_000_000).toFixed(2) + 'M';
   if (n >= 1_000) return (n / 1_000).toFixed(1) + 'k';
-  return String(n);
+  return String(Math.floor(n));
 }
 
 function formatLine({ state, usage, isActive }) {
@@ -116,13 +213,16 @@ function formatLine({ state, usage, isActive }) {
     ratio >= 0.7 ? ANSI.yellow :
     ANSI.green;
 
+  // 色覚配慮: 色だけでなく記号 / テキスト接頭辞でも重要度を示す
+  //   90%超: !! + 強い文言 (赤)
+  //   70%超: !  + 弱い文言 (黄)
   const warn =
-    ratio >= 0.9 ? color(ANSI.red, '  ⚠ /clear 強く推奨') :
-    ratio >= 0.7 ? color(ANSI.yellow, '  ⚠ そろそろ /clear') :
+    ratio >= 0.9 ? color(ANSI.red + ANSI.bold, '  !! /clear 強く推奨') :
+    ratio >= 0.7 ? color(ANSI.yellow, '  !  そろそろ /clear') :
     '';
 
   const marker = isActive ? color(ANSI.bold + ANSI.cyan, '▶') : ' ';
-  const projectCol = project.padEnd(18).slice(0, 18);
+  const projectCol = padCellsEnd(project, 18);
   const idCol = color(ANSI.dim, shortId);
   const barCol = color(barColor, bar);
   const tokCol = `${formatNumber(tokens).padStart(6)} / ${pct.toString().padStart(3)}%`;
@@ -133,11 +233,18 @@ function formatLine({ state, usage, isActive }) {
 }
 
 // --- フィルタ ---
+/**
+ * セッション一覧に表示フィルタを適用する。
+ * ルール:
+ *   - stale (15 分無活動) は基本非表示。--all のときのみ stale も含める
+ *   - --session が指定されればプレフィックス一致、ただし base (stale フィルタ通過済み) 上で絞る
+ *   - --session 無し & --all 無しのときは cwd 一致のみ残す
+ */
 function filterStates(states, args, cwd) {
-  // stale (15 分無活動) は基本非表示。--all のときだけ stale も含める
-  let base = args.all ? states : states.filter((s) => !s.stale);
+  const base = args.all ? states : states.filter((s) => !s.stale);
   if (args.session) {
-    return states.filter((s) => s.sessionId === args.session || s.sessionId.startsWith(args.session));
+    // startsWith が完全一致も含むので === は冗長
+    return base.filter((s) => s.sessionId.startsWith(args.session));
   }
   if (args.all) return base;
   const normalizedCwd = normalizeProjectPath(cwd);
@@ -146,24 +253,55 @@ function filterStates(states, args, cwd) {
 
 // --- メインループ ---
 let lastRenderedLines = 0;
-let lastMtimes = new Map();
+let lastRenderKey = '';
+
+/**
+ * 再描画要否の判定キー。state ファイル群の mtime と transcript JSONL の size を
+ * 1 本の文字列にまとめてハッシュキーとする。キーが前回と同じなら描画スキップ。
+ *
+ * 注: transcript は JSONL append-only なので size 変化 = 新しい usage エントリ到来と
+ * 同義。mtime だけでは transcript 更新を検出できない（state-file の mtime は
+ * Stop hook のタイミングで更新され、transcript は Claude の stream 中に太る）。
+ */
+function computeRenderKey() {
+  const parts = [];
+  // state mtimes
+  const mtimes = snapshotStateMtimes();
+  const names = Array.from(mtimes.keys()).sort();
+  for (const name of names) parts.push(`s:${name}:${mtimes.get(name)}`);
+  // transcript sizes（state ファイルを読まずに直接 stat、IO 最小化）
+  try {
+    const states = readAllSessionStates();
+    for (const st of states) {
+      if (!st.transcriptPath || !existsSync(st.transcriptPath)) continue;
+      try {
+        const size = statSync(st.transcriptPath).size;
+        parts.push(`t:${st.sessionId}:${size}`);
+      } catch {
+        // stat 失敗は無視（次フレームで回復）
+      }
+    }
+  } catch {
+    // readAllSessionStates 自体の失敗も 1 フレームで回復
+  }
+  return parts.join('|');
+}
 
+/**
+ * 前回と比べてキーが変化していれば true。副作用として lastRenderKey を更新する。
+ */
 function needsRerender() {
-  const current = snapshotStateMtimes();
-  if (current.size !== lastMtimes.size) {
-    lastMtimes = current;
+  const key = computeRenderKey();
+  if (key !== lastRenderKey) {
+    lastRenderKey = key;
     return true;
   }
-  for (const [name, mtime] of current) {
-    if (lastMtimes.get(name) !== mtime) {
-      lastMtimes = current;
-      return true;
-    }
-  }
-  // mtime は同じでも transcript JSONL のサイズが変われば再描画したい
-  // → transcript-usage のキャッシュ判定に任せるため毎秒呼ぶ設計。
-  //    state ファイル変化なしでも再計算は走らせる（キャッシュヒット時は軽量）
-  return true;
+  return false;
+}
+
+/** テスト用リセット */
+function resetRenderKeyCache() {
+  lastRenderKey = '';
 }
 
 function renderFrame(args) {
@@ -174,9 +312,15 @@ function renderFrame(args) {
 
   const lines = [];
   if (filtered.length === 0) {
-    lines.push(color(ANSI.dim, '[Throughline] 待機中 — アクティブなセッションがありません'));
-    if (!args.all) {
-      lines.push(color(ANSI.dim, `  (${normalizeProjectPath(process.cwd())} に state 無し。--all で全プロジェクト表示)`));
+    if (args.session) {
+      // --session 指定で未ヒットは「存在しない」と明示（一般の "待機中" と区別）
+      lines.push(color(ANSI.yellow, `[Throughline] セッション "${args.session}" に一致する active セッションが見つかりません`));
+      lines.push(color(ANSI.dim, '  (プレフィックス指定も可。--all で stale を含めて再検索)'));
+    } else {
+      lines.push(color(ANSI.dim, '[Throughline] 待機中 — アクティブなセッションがありません'));
+      if (!args.all) {
+        lines.push(color(ANSI.dim, `  (${normalizeProjectPath(process.cwd())} に state 無し。--all で全プロジェクト表示)`));
+      }
     }
   } else {
     const header = color(
@@ -191,13 +335,14 @@ function renderFrame(args) {
     }
   }
 
-  // ★ 折り返し対策: 各行を (columns - 1) 幅に切り詰めて物理 1 行に収める。
+  // ★ 折り返し対策: 各行を (columns - 1) セル幅に切り詰めて物理 1 行に収める。
   //   こうすれば ANSI.up(lines.length) と論理行数が物理行数と一致する。
   //   columns - 1 にしてるのはターミナル末尾列に書くと自動改行する端末があるため。
+  //   truncateToCells は CJK / 絵文字を 2 セルとして正しく数える。
   const columns = process.stdout.columns && process.stdout.columns > 10
     ? process.stdout.columns - 1
     : 120;
-  const clipped = lines.map((l) => truncateToWidth(l, columns));
+  const clipped = lines.map((l) => truncateToCells(l, columns));
 
   // 前フレームを消去してから再描画:
   //   1. カーソルを前フレームの先頭行へ戻す (CUU = 行移動のみ)
@@ -213,25 +358,98 @@ function renderFrame(args) {
 }
 
 // --- 起動 ---
-function main() {
-  const args = parseArgs(process.argv.slice(2));
+let cursorRestored = false;
+function restoreCursor() {
+  if (cursorRestored) return;
+  cursorRestored = true;
+  try {
+    process.stdout.write(ANSI.showCursor);
+  } catch {
+    // stdout がすでに閉じていても無視
+  }
+}
+
+function safeRenderFrame(args) {
+  try {
+    renderFrame(args);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : 'unknown error';
+    process.stderr.write(`[Throughline] render error: ${msg}\n`);
+    // 1 フレームの失敗で常駐を落とさない。次フレームで回復を試す
+  }
+}
+
+export function main() {
+  let args;
+  try {
+    args = parseArgs(process.argv.slice(2));
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : 'invalid args';
+    process.stderr.write(`[Throughline] ${msg}\n`);
+    process.exit(2);
+  }
 
   process.stdout.write(ANSI.hideCursor);
   process.stdout.write(color(ANSI.dim, `[Throughline] モニター起動 (state: ${getStateDir()}, Ctrl+C で終了)\n`));
 
-  renderFrame(args);
+  safeRenderFrame(args);
   const timer = setInterval(() => {
-    if (needsRerender()) renderFrame(args);
+    if (needsRerender()) safeRenderFrame(args);
   }, REFRESH_MS);
 
-  const shutdown = () => {
+  // ターミナル幅が変わったら即座に全画面リフレッシュ（前フレームの ANSI 座標が無効化されるため）
+  // debounce 200ms でドラッグ中のジッタを吸収
+  let resizeTimer = null;
+  const onResize = () => {
+    if (resizeTimer) clearTimeout(resizeTimer);
+    resizeTimer = setTimeout(() => {
+      resizeTimer = null;
+      // 既存描画が新しい幅では崩れている可能性があるため座標情報を破棄して再描画
+      lastRenderedLines = 0;
+      resetRenderKeyCache();
+      safeRenderFrame(args);
+    }, 200);
+  };
+  if (typeof process.stdout.on === 'function') {
+    process.stdout.on('resize', onResize);
+  }
+
+  const shutdown = (code = 0) => {
     clearInterval(timer);
-    process.stdout.write('\n' + ANSI.showCursor);
-    process.stdout.write(color(ANSI.dim, '[Throughline] モニター終了\n'));
-    process.exit(0);
+    if (resizeTimer) clearTimeout(resizeTimer);
+    restoreCursor();
+    process.stdout.write('\n' + color(ANSI.dim, '[Throughline] モニター終了\n'));
+    process.exit(code);
   };
-  process.on('SIGINT', shutdown);
-  process.on('SIGTERM', shutdown);
+  process.on('SIGINT', () => shutdown(0));
+  process.on('SIGTERM', () => shutdown(0));
+
+  // クラッシュ時もカーソルを必ず戻す
+  process.on('exit', restoreCursor);
+  process.on('uncaughtException', (err) => {
+    restoreCursor();
+    const msg = err instanceof Error ? (err.stack ?? err.message) : String(err);
+    process.stderr.write(`[Throughline] uncaught exception:\n${msg}\n`);
+    process.exit(1);
+  });
+  process.on('unhandledRejection', (reason) => {
+    restoreCursor();
+    process.stderr.write(`[Throughline] unhandled rejection: ${String(reason)}\n`);
+    process.exit(1);
+  });
 }
 
-main();
+// --- テスト用エクスポート（本番コードからは参照しない） ---
+export const _internal = {
+  parseArgs,
+  filterStates,
+  cellWidth,
+  truncateToCells,
+  padCellsEnd,
+  formatNumber,
+  renderBar,
+  formatLine,
+  computeRenderKey,
+  needsRerender,
+  resetRenderKeyCache,
+};