throughline 0.3.10 → 0.3.12

package/package.json

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

package/src/token-monitor.mjs

@@ -17,9 +17,10 @@
  *   - トークン数は transcript JSONL の最新 assistant usage を直読
  */
 
-import { basename } from 'node:path';
+import { basename, dirname, join } from 'node:path';
 import { stripVTControlCharacters } from 'node:util';
-import { statSync, existsSync } from 'node:fs';
+import { statSync, existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { getStateDir, readAllSessionStates, snapshotStateMtimes, normalizeProjectPath } from './state-file.mjs';
 import { readLatestUsage } from './transcript-usage.mjs';
 
@@ -34,7 +35,11 @@ const ANSI = {
   hideCursor: '\x1b[?25l',
   showCursor: '\x1b[?25h',
   clearLine: '\x1b[2K',
-  clearScreen: '\x1b[2J\x1b[H',
+  // xterm.js は `\x1b[2J` (ED2) をビューポート消去としてしか実装しておらず、
+  // 消えた内容はスクロールバックに残る（xterm.js issue #5019 の jerch コメント参照）。
+  // VSCode task panel でフレーム更新が「積み上がる」ように見えるのはこれが原因。
+  // `\x1b[3J` (ED3) を続けて送るとスクロールバックも消えて真の全クリアになる。
+  clearScreen: '\x1b[2J\x1b[3J\x1b[H',
   clearBelow: '\x1b[0J',        // 現在位置から画面末尾までをクリア
   up: (n) => `\x1b[${n}A`,       // CUU: カーソルを N 行上へ (列は変えない)
   reset: '\x1b[0m',
@@ -162,14 +167,16 @@ function padCellsEnd(s, targetCells) {
 // --- CLI 引数 ---
 /**
  * @param {string[]} argv
- * @returns {{all: boolean, session: string|null}}
+ * @returns {{all: boolean, session: string|null, diag: boolean}}
  * @throws {Error} --session に値が欠落している場合
  */
 function parseArgs(argv) {
-  const args = { all: false, session: null };
+  const args = { all: false, session: null, diag: false };
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === '--all') {
       args.all = true;
+    } else if (argv[i] === '--diag') {
+      args.diag = true;
     } else if (argv[i] === '--session') {
       const value = argv[i + 1];
       if (value === undefined || value.startsWith('--')) {
@@ -462,6 +469,79 @@ function safeRenderFrame(args) {
   }
 }
 
+/**
+ * 環境診断モード。ユーザー環境で「モニターの描画が壊れる」と報告されたときに、
+ * 実際の process.stdout / env / TERM の値をその場で可視化するための一発起動モード。
+ *
+ * 過去に「`type: process` だと非 TTY」「`type: shell` なら PTY」など推測で描画戦略を
+ * 変えてきたが、PTY が張られるかどうかは VSCode のバージョンや Windows の ConPTY
+ * 実装に依存し、推測は外れ続けた。このコマンドで実測値を 1 ページに出すことで、
+ * 「この環境では何が起きているか」を断定できるようにする。
+ *
+ * 出力は ~/.throughline/last-diag.txt にも保存する。task terminal のようにスクロール
+ * バックが分かりづらい環境でも後からファイルを読めば全情報を回収できる。
+ */
+function runDiagnostic() {
+  const lines = [];
+  const emit = (s) => {
+    process.stdout.write(s);
+    lines.push(s);
+  };
+  const out = (k, v) => emit(`${k.padEnd(28)}${v}\n`);
+
+  emit('=== Throughline monitor diagnostic ===\n');
+  emit(`timestamp: ${new Date().toISOString()}\n\n`);
+
+  emit('[process.stdout]\n');
+  out('  isTTY', String(Boolean(process.stdout.isTTY)));
+  out('  columns', String(process.stdout.columns ?? '(undefined)'));
+  out('  rows', String(process.stdout.rows ?? '(undefined)'));
+  out('  hasColors()',
+    typeof process.stdout.hasColors === 'function'
+      ? String(process.stdout.hasColors())
+      : '(n/a)',
+  );
+  emit('\n');
+
+  emit('[process.stderr]\n');
+  out('  isTTY', String(Boolean(process.stderr.isTTY)));
+  emit('\n');
+
+  emit('[env]\n');
+  for (const key of ['TERM', 'TERM_PROGRAM', 'TERM_PROGRAM_VERSION', 'COLORTERM', 'COLUMNS', 'LINES', 'VSCODE_PID', 'VSCODE_IPC_HOOK_CLI', 'VSCODE_INJECTION', 'VSCODE_SHELL_INTEGRATION', 'WT_SESSION', 'ConEmuPID', 'OSTYPE', 'MSYSTEM']) {
+    out(`  ${key}`, process.env[key] ?? '(unset)');
+  }
+  emit('\n');
+
+  emit('[resolveColumns()]\n');
+  out('  value', String(resolveColumns()));
+  emit('\n');
+
+  emit('[platform]\n');
+  out('  process.platform', process.platform);
+  out('  process.versions.node', process.versions.node);
+  emit('\n');
+
+  emit('=== end of diag ===\n');
+  emit('\nこの出力を全文コピーするか、~/.throughline/last-diag.txt を開いて内容を共有してください。\n');
+  emit('task terminal でスクロールして読めない場合は PowerShell で\n');
+  emit('  cat ~/.throughline/last-diag.txt\n');
+  emit('を実行すれば同じ内容が読めます。\n');
+
+  // ログファイルに保存 (task terminal のようにスクロール不能な環境向け)
+  try {
+    const logPath = join(homedir(), '.throughline', 'last-diag.txt');
+    mkdirSync(dirname(logPath), { recursive: true });
+    writeFileSync(logPath, lines.join(''));
+    emit(`\n[ログ保存] ${logPath}\n`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : 'unknown';
+    emit(`\n[ログ保存失敗] ${msg}\n`);
+  }
+
+  process.exit(0);
+}
+
 export function main() {
   let args;
   try {
@@ -472,6 +552,11 @@ export function main() {
     process.exit(2);
   }
 
+  if (args.diag) {
+    runDiagnostic();
+    return;
+  }
+
   process.stdout.write(ANSI.hideCursor);
   process.stdout.write(color(ANSI.dim, `[Throughline] モニター起動 (state: ${getStateDir()}, Ctrl+C で終了)\n`));
 

package/src/token-monitor.test.mjs

@@ -26,19 +26,23 @@ const CWD_BAR = normalizeProjectPath('/tmp/bar');
 // ─── parseArgs ─────────────────────────────────────────────────────
 
 test('parseArgs: 引数なしは defaults', () => {
-  assert.deepEqual(parseArgs([]), { all: false, session: null });
+  assert.deepEqual(parseArgs([]), { all: false, session: null, diag: false });
 });
 
 test('parseArgs: --all フラグ', () => {
-  assert.deepEqual(parseArgs(['--all']), { all: true, session: null });
+  assert.deepEqual(parseArgs(['--all']), { all: true, session: null, diag: false });
 });
 
 test('parseArgs: --session <id>', () => {
-  assert.deepEqual(parseArgs(['--session', 'abc123']), { all: false, session: 'abc123' });
+  assert.deepEqual(parseArgs(['--session', 'abc123']), { all: false, session: 'abc123', diag: false });
+});
+
+test('parseArgs: --diag フラグ (環境診断モード)', () => {
+  assert.deepEqual(parseArgs(['--diag']), { all: false, session: null, diag: true });
 });
 
 test('parseArgs: --all と --session の組み合わせ', () => {
-  assert.deepEqual(parseArgs(['--all', '--session', 'abc']), { all: true, session: 'abc' });
+  assert.deepEqual(parseArgs(['--all', '--session', 'abc']), { all: true, session: 'abc', diag: false });
 });
 
 test('parseArgs: --session 値欠落は throw する', () => {
@@ -51,7 +55,7 @@ test('parseArgs: --session の次が別フラグなら throw する', () => {
 
 test('parseArgs: 未知の引数は黙殺', () => {
   // 将来 --help などを足す余地を残すため、現状は黙殺で OK
-  assert.deepEqual(parseArgs(['--unknown', 'value']), { all: false, session: null });
+  assert.deepEqual(parseArgs(['--unknown', 'value']), { all: false, session: null, diag: false });
 });
 
 // ─── filterStates ─────────────────────────────────────────────────