throughline 0.3.7 → 0.3.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "type": "module",
   "description": "Claude Code hooks plugin for structured context compression (/clear-safe persistent memory)",
   "keywords": [

package/src/token-monitor.mjs

@@ -33,6 +33,12 @@ let lastTimeAgoRefresh = Date.now();
 const ANSI = {
   hideCursor: '\x1b[?25l',
   showCursor: '\x1b[?25h',
+  // オルタネートスクリーンバッファ (htop / vim / less が使うやつ)。
+  // プライマリバッファでの `\x1b[2J` は xterm.js だと「描画済み行をスクロール履歴に
+  // 押し上げる」挙動になり、狭い VSCode task terminal で描画が永遠に積み上がる
+  // 症状を引き起こす。alt バッファならスクロール履歴に残らず真にクリアできる。
+  enterAltScreen: '\x1b[?1049h',
+  leaveAltScreen: '\x1b[?1049l',
   clearLine: '\x1b[2K',
   clearScreen: '\x1b[2J\x1b[H',
   clearBelow: '\x1b[0J',        // 現在位置から画面末尾までをクリア
@@ -420,13 +426,20 @@ function renderFrame(args) {
   const columns = resolveColumns();
   const clipped = lines.map((l) => truncateToCells(l, columns));
 
-  // 前フレームを消去してから再描画:
-  //   1. カーソルを前フレームの先頭行へ戻す (CUU = 行移動のみ)
-  //   2. 列 1 へ戻す (CR)
-  //   3. 現在位置から画面末尾までを一括消去 (ED 0)
-  // CPL (\x1b[nF) は VSCode 統合ターミナルで挙動が不安定だったため使わない
-  if (lastRenderedLines > 0) {
-    process.stdout.write(ANSI.up(lastRenderedLines) + '\r' + ANSI.clearBelow);
+  // 再描画戦略:
+  //   - TTY: 真の columns が分かるので CUU + clearBelow で部分再描画（省フリッカ）
+  //   - 非 TTY (VSCode の type:process タスク等): columns を信用できないので 200 で
+  //     truncate しているが、実ターミナル幅が 200 未満なら自動改行が起き、論理行数と
+  //     物理行数がズレて CUU が誤作動する（「1 セッション」行が毎フレーム積み上がる
+  //     バグを実機で確認）。非 TTY では画面全クリアで愚直に描き直す方が確実。
+  //   どちらも差分検知 (needsRerender) を通過したフレームのみ書き込むので、
+  //   フリッカ量はデータ変化頻度に比例するだけで爆発しない。
+  if (process.stdout.isTTY) {
+    if (lastRenderedLines > 0) {
+      process.stdout.write(ANSI.up(lastRenderedLines) + '\r' + ANSI.clearBelow);
+    }
+  } else {
+    process.stdout.write(ANSI.clearScreen);
   }
 
   process.stdout.write(clipped.join('\n') + '\n');
@@ -434,12 +447,18 @@ function renderFrame(args) {
 }
 
 // --- 起動 ---
-let cursorRestored = false;
+let terminalRestored = false;
+/**
+ * 終了時に端末状態を元に戻す:
+ *   - オルタネートスクリーンバッファから抜ける (起動前の画面に戻る)
+ *   - カーソル表示を復活
+ * 2 回以上呼ばれても安全 (冪等)。
+ */
 function restoreCursor() {
-  if (cursorRestored) return;
-  cursorRestored = true;
+  if (terminalRestored) return;
+  terminalRestored = true;
   try {
-    process.stdout.write(ANSI.showCursor);
+    process.stdout.write(ANSI.leaveAltScreen + ANSI.showCursor);
   } catch {
     // stdout がすでに閉じていても無視
   }
@@ -465,7 +484,9 @@ export function main() {
     process.exit(2);
   }
 
-  process.stdout.write(ANSI.hideCursor);
+  // オルタネートスクリーンバッファに入る → プライマリ画面を保存、クリア時に履歴に残らない。
+  // これにより「1 セッション」ヘッダが再描画のたびに積み上がる不具合を根絶できる。
+  process.stdout.write(ANSI.enterAltScreen + ANSI.hideCursor);
   process.stdout.write(color(ANSI.dim, `[Throughline] モニター起動 (state: ${getStateDir()}, Ctrl+C で終了)\n`));
 
   safeRenderFrame(args);