throughline 0.1.0

package/src/token-monitor.mjs

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+/**
+ * token-monitor.mjs — マルチセッション対応トークンモニター
+ *
+ * 使い方:
+ *   throughline monitor                  現在のプロジェクトの全 active セッション
+ *   throughline monitor --all             全プロジェクト全セッション
+ *   throughline monitor --session <id>    特定セッションのみ
+ *
+ * VS Code の分割ターミナルなどで常時起動しておく。
+ *
+ * 設計: docs/PUBLIC_RELEASE_PLAN.md §4.5/4.6
+ *   - 状態ファイルはセッション単位 (~/.throughline/state/<session_id>.json)
+ *   - setInterval (1s) + mtime 差分検知で更新を捕捉
+ *   - updatedAt 降順ソート、先頭行を ▶ でハイライト
+ *   - stale は PID 生存チェックで判定
+ *   - トークン数は transcript JSONL の最新 assistant usage を直読
+ */
+
+import { basename } from 'node:path';
+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;
+
+// --- ANSI ---
+const ANSI = {
+  hideCursor: '\x1b[?25l',
+  showCursor: '\x1b[?25h',
+  clearLine: '\x1b[2K',
+  clearScreen: '\x1b[2J\x1b[H',
+  clearBelow: '\x1b[0J',        // 現在位置から画面末尾までをクリア
+  up: (n) => `\x1b[${n}A`,       // CUU: カーソルを N 行上へ (列は変えない)
+  reset: '\x1b[0m',
+  dim: '\x1b[2m',
+  bold: '\x1b[1m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+};
+
+function color(c, text) {
+  return `${c}${text}${ANSI.reset}`;
+}
+
+/** ANSI エスケープシーケンスを除いた可視文字数を返す（サロゲートペア考慮はしない簡易版） */
+function visibleLength(s) {
+  return stripAnsi(s).length;
+}
+
+/**
+ * 行をターミナル幅に収まるよう切り詰める。ANSI コードを壊さないため、
+ * 可視文字だけを数えながらコピーし、上限に達したら reset を付けて返す。
+ * @param {string} line
+ * @param {number} maxWidth
+ */
+function truncateToWidth(line, maxWidth) {
+  if (maxWidth <= 0) return '';
+  if (visibleLength(line) <= maxWidth) return line;
+  let out = '';
+  let visible = 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;
+      continue;
+    }
+    out += ch;
+    visible++;
+    i++;
+  }
+  return out + ANSI.reset;
+}
+
+// --- CLI 引数 ---
+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];
+  }
+  return args;
+}
+
+// --- 表示 ---
+function renderBar(ratio, width = 20) {
+  const filled = Math.max(0, Math.min(width, Math.round(ratio * width)));
+  return '█'.repeat(filled) + '░'.repeat(width - filled);
+}
+
+function formatNumber(n) {
+  if (n >= 1_000_000) return (n / 1_000_000).toFixed(2) + 'M';
+  if (n >= 1_000) return (n / 1_000).toFixed(1) + 'k';
+  return String(n);
+}
+
+function formatLine({ state, usage, isActive }) {
+  const project = basename(state.projectPath || '?');
+  const shortId = state.sessionId.slice(0, 8);
+  const tokens = usage?.tokens ?? 0;
+  const max = usage?.contextWindowSize ?? 200_000;
+  const ratio = max > 0 ? tokens / max : 0;
+  const pct = Math.round(ratio * 100);
+  const remaining = Math.max(0, max - tokens);
+
+  const bar = renderBar(ratio);
+  const barColor =
+    ratio >= 0.9 ? ANSI.red :
+    ratio >= 0.7 ? ANSI.yellow :
+    ANSI.green;
+
+  const warn =
+    ratio >= 0.9 ? color(ANSI.red, '  ⚠ /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 idCol = color(ANSI.dim, shortId);
+  const barCol = color(barColor, bar);
+  const tokCol = `${formatNumber(tokens).padStart(6)} / ${pct.toString().padStart(3)}%`;
+  const remCol = color(ANSI.dim, `残 ${formatNumber(remaining)}`);
+  const modelCol = usage?.model ? color(ANSI.dim, usage.model) : color(ANSI.dim, '(未取得)');
+
+  return `${marker} ${projectCol} ${idCol} ${barCol} ${tokCol}  ${remCol}  ${modelCol}${warn}`;
+}
+
+// --- フィルタ ---
+function filterStates(states, args, cwd) {
+  // stale (15 分無活動) は基本非表示。--all のときだけ stale も含める
+  let 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));
+  }
+  if (args.all) return base;
+  const normalizedCwd = normalizeProjectPath(cwd);
+  return base.filter((s) => s.projectPath === normalizedCwd);
+}
+
+// --- メインループ ---
+let lastRenderedLines = 0;
+let lastMtimes = new Map();
+
+function needsRerender() {
+  const current = snapshotStateMtimes();
+  if (current.size !== lastMtimes.size) {
+    lastMtimes = current;
+    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;
+}
+
+function renderFrame(args) {
+  const states = readAllSessionStates();
+  const filtered = filterStates(states, args, process.cwd()).sort(
+    (a, b) => b.updatedAt - a.updatedAt,
+  );
+
+  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 で全プロジェクト表示)`));
+    }
+  } else {
+    const header = color(
+      ANSI.bold,
+      `[Throughline] ${filtered.length} セッション${args.all ? ' (--all)' : ''}`,
+    );
+    lines.push(header);
+    for (let i = 0; i < filtered.length; i++) {
+      const state = filtered[i];
+      const usage = state.transcriptPath ? readLatestUsage(state.transcriptPath) : null;
+      lines.push(formatLine({ state, usage, isActive: i === 0 }));
+    }
+  }
+
+  // ★ 折り返し対策: 各行を (columns - 1) 幅に切り詰めて物理 1 行に収める。
+  //   こうすれば ANSI.up(lines.length) と論理行数が物理行数と一致する。
+  //   columns - 1 にしてるのはターミナル末尾列に書くと自動改行する端末があるため。
+  const columns = process.stdout.columns && process.stdout.columns > 10
+    ? process.stdout.columns - 1
+    : 120;
+  const clipped = lines.map((l) => truncateToWidth(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);
+  }
+
+  process.stdout.write(clipped.join('\n') + '\n');
+  lastRenderedLines = clipped.length;
+}
+
+// --- 起動 ---
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  process.stdout.write(ANSI.hideCursor);
+  process.stdout.write(color(ANSI.dim, `[Throughline] モニター起動 (state: ${getStateDir()}, Ctrl+C で終了)\n`));
+
+  renderFrame(args);
+  const timer = setInterval(() => {
+    if (needsRerender()) renderFrame(args);
+  }, REFRESH_MS);
+
+  const shutdown = () => {
+    clearInterval(timer);
+    process.stdout.write('\n' + ANSI.showCursor);
+    process.stdout.write(color(ANSI.dim, '[Throughline] モニター終了\n'));
+    process.exit(0);
+  };
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+}
+
+main();

package/src/transcript-reader.mjs

@@ -0,0 +1,364 @@
+/**
+ * transcript-reader.mjs
+ * Claude Code のトランスクリプト JSONL を解析するモジュール。
+ *
+ * 実際のフォーマット（確認済み）:
+ *   {type: "user",      message: {role: "user",      content: [{type:"text", text:"..."}]}, ...}
+ *   {type: "assistant", message: {role: "assistant", content: [{type:"text", text:"..."}, {type:"thinking", ...}]}, ...}
+ *   他に queue-operation, attachment, file-history-snapshot 等があるが無視する
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { DETAIL_KIND } from './constants.mjs';
+
+/**
+ * content 配列からテキスト部分だけを結合する。
+ * thinking ブロックは除外。
+ * @param {unknown} content
+ * @returns {string}
+ */
+function extractText(content) {
+  if (typeof content === 'string') return content;
+  if (Array.isArray(content)) {
+    return content
+      .filter((b) => b && b.type === 'text' && typeof b.text === 'string')
+      .map((b) => b.text)
+      .join('');
+  }
+  return String(content ?? '');
+}
+
+/**
+ * トランスクリプト JSONL ファイルを読んで全ターンを返す。
+ * @param {string} transcriptPath
+ * @returns {Array<{role: string, content: string, turn_number: number}>}
+ */
+export function readTranscript(transcriptPath) {
+  if (!transcriptPath || !existsSync(transcriptPath)) return [];
+
+  // existsSync で早期 return 済み。ここでの read 失敗は権限エラー等の本物の異常なので throw させる (§0 ルール)
+  const raw = readFileSync(transcriptPath, 'utf8');
+
+  const turns = [];
+  for (const line of raw.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+
+    let entry;
+    try {
+      entry = JSON.parse(trimmed);
+    } catch {
+      continue;
+    }
+
+    // user / assistant エントリのみ対象
+    if (entry.type !== 'user' && entry.type !== 'assistant') continue;
+
+    const msg = entry.message;
+    if (!msg || !msg.role || msg.content == null) continue;
+
+    const text = extractText(msg.content);
+    if (!text) continue;
+
+    turns.push({
+      role: msg.role,
+      content: text,
+      turn_number: turns.length,
+    });
+  }
+
+  return turns;
+}
+
+/**
+ * ANSI エスケープシーケンスを除去する。
+ * ツール出力（特に Bash）にしばしば含まれる色コードを剥がす。
+ * @param {string} s
+ */
+export function stripAnsi(s) {
+  if (typeof s !== 'string') return s;
+  // eslint-disable-next-line no-control-regex
+  return s.replace(/\x1b\[[0-9;?]*[a-zA-Z]/g, '');
+}
+
+/**
+ * tool_result の content フィールドを単一テキストに正規化する。
+ * 実際のフォーマット:
+ *   - string: そのまま
+ *   - Array<{type:"text", text:string} | {type:"image", ...}>: text を結合、
+ *     image は `[image]` プレースホルダ
+ * @param {unknown} content
+ * @returns {string}
+ */
+export function normalizeToolResultContent(content) {
+  if (typeof content === 'string') return content;
+  if (Array.isArray(content)) {
+    return content
+      .map((b) => {
+        if (b && b.type === 'text' && typeof b.text === 'string') return b.text;
+        if (b && b.type === 'image') return '[image]';
+        return '';
+      })
+      .join('');
+  }
+  return '';
+}
+
+/**
+ * transcript JSONL を 1 行ずつ解析して、生エントリ配列を返す。
+ * 未知 type や parse 失敗は skip（§0 ルール: 上位で扱う）。
+ *
+ * @param {string} transcriptPath
+ * @returns {Array<object>}
+ */
+export function readRawEntries(transcriptPath) {
+  if (!transcriptPath || !existsSync(transcriptPath)) return [];
+  const raw = readFileSync(transcriptPath, 'utf8');
+  const entries = [];
+  for (const line of raw.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      entries.push(JSON.parse(trimmed));
+    } catch {
+      // 末尾 partial-write は JSONL 仕様上の許容
+      continue;
+    }
+  }
+  return entries;
+}
+
+/**
+ * 現在の「論理ターン」を構成するエントリ範囲を切り出す。
+ * 定義: 最後の assistant text ブロック (= Stop 時点の Claude 最終応答) を含むターン
+ *       = 1 つ前の user text エントリの次から、最後の assistant エントリまで。
+ *
+ * 論理ターンの構造:
+ *   user(text)                 ← このターンの開始
+ *   assistant(thinking + tool_use)
+ *   user(tool_result)
+ *   assistant(text)            ← このターンの終わり
+ *
+ * 間にある attachment / system エントリも同範囲に含める。
+ *
+ * @param {Array<object>} entries readRawEntries の結果
+ * @returns {Array<object>} 論理ターンに属するエントリのスライス
+ */
+export function sliceCurrentTurnEntries(entries) {
+  if (!entries.length) return [];
+
+  // 最後の assistant text ブロックを含むエントリを探す
+  let lastAssistantTextIdx = -1;
+  for (let i = entries.length - 1; i >= 0; i--) {
+    const e = entries[i];
+    if (e.type !== 'assistant') continue;
+    const blocks = e.message?.content;
+    if (!Array.isArray(blocks)) continue;
+    if (blocks.some((b) => b && b.type === 'text' && typeof b.text === 'string' && b.text.length > 0)) {
+      lastAssistantTextIdx = i;
+      break;
+    }
+  }
+  if (lastAssistantTextIdx < 0) return [];
+
+  // そこから遡って、最後の user text ブロックを含むエントリを探す
+  let userTextIdx = -1;
+  for (let i = lastAssistantTextIdx - 1; i >= 0; i--) {
+    const e = entries[i];
+    if (e.type !== 'user') continue;
+    const blocks = e.message?.content;
+    if (Array.isArray(blocks)) {
+      if (blocks.some((b) => b && b.type === 'text' && typeof b.text === 'string' && b.text.length > 0)) {
+        userTextIdx = i;
+        break;
+      }
+    } else if (typeof blocks === 'string' && blocks.length > 0) {
+      userTextIdx = i;
+      break;
+    }
+  }
+  if (userTextIdx < 0) return [];
+
+  return entries.slice(userTextIdx, lastAssistantTextIdx + 1);
+}
+
+/**
+ * 論理ターン内の全エントリから L3 (details) 用の生レコードを抽出する。
+ *
+ * 返す各レコード:
+ *   {
+ *     kind: 'tool_input' | 'tool_output' | 'system',
+ *     tool_name: string,       // 表示用。system は 'SystemReminder' 等
+ *     source_id: string,       // 冪等再処理キー (tool_use.id / tool_use_id / uuid)
+ *     input_text: string | null,
+ *     output_text: string | null,
+ *   }
+ *
+ * 分類ルール:
+ *   - assistant の tool_use ブロック → tool_input (name, input を JSON 化して input_text に)
+ *   - user の tool_result ブロック → tool_output (content を output_text に、ANSI 剥離)
+ *   - assistant/user の thinking ブロック → 破棄
+ *   - assistant/user の text ブロック → 扱わない（L2 bodies 側の責務）
+ *   - attachment entry (hook_success) → system (hookName + content を出力に)
+ *   - system entry (stop_hook_summary) → skip（hook タイミング情報で意味なし）
+ *   - image ブロック → placeholder で kind='image'
+ *
+ * @param {Array<object>} turnEntries sliceCurrentTurnEntries の結果
+ * @returns {Array<{kind: string, tool_name: string, source_id: string, input_text: string|null, output_text: string|null}>}
+ */
+export function extractDetailBlocks(turnEntries) {
+  const out = [];
+  // tool_use の name を後で tool_result にも添付するためのマップ
+  const toolNameById = new Map();
+
+  for (const e of turnEntries) {
+    if (e.type === 'assistant') {
+      const blocks = e.message?.content;
+      if (!Array.isArray(blocks)) continue;
+      for (const b of blocks) {
+        if (!b || !b.type) continue;
+        if (b.type === 'tool_use' && typeof b.id === 'string') {
+          toolNameById.set(b.id, b.name ?? 'unknown');
+          out.push({
+            kind: DETAIL_KIND.TOOL_INPUT,
+            tool_name: b.name ?? 'unknown',
+            source_id: b.id,
+            input_text: JSON.stringify(b.input ?? null),
+            output_text: null,
+          });
+        } else if (b.type === 'image') {
+          out.push({
+            kind: DETAIL_KIND.IMAGE,
+            tool_name: 'image',
+            source_id: null,
+            input_text: null,
+            output_text: '[image]',
+          });
+        }
+        // text / thinking は扱わない
+      }
+    } else if (e.type === 'user') {
+      const blocks = e.message?.content;
+      if (!Array.isArray(blocks)) continue;
+      for (const b of blocks) {
+        if (!b || !b.type) continue;
+        if (b.type === 'tool_result') {
+          const toolUseId = b.tool_use_id ?? null;
+          const toolName = toolUseId && toolNameById.has(toolUseId)
+            ? toolNameById.get(toolUseId)
+            : 'unknown';
+          const rawOutput = normalizeToolResultContent(b.content);
+          out.push({
+            kind: DETAIL_KIND.TOOL_OUTPUT,
+            tool_name: toolName,
+            source_id: toolUseId ? `${toolUseId}:result` : null,
+            input_text: null,
+            output_text: stripAnsi(rawOutput),
+          });
+        } else if (b.type === 'image') {
+          out.push({
+            kind: DETAIL_KIND.IMAGE,
+            tool_name: 'image',
+            source_id: null,
+            input_text: null,
+            output_text: '[image]',
+          });
+        }
+        // text は扱わない
+      }
+    } else if (e.type === 'attachment') {
+      // attachment は Claude Code が会話に差し込むコンテキスト全般を表す汎用エンベロープ。
+      // 既知の種別（実機観測）:
+      //   hook_success, async_hook_response, hook_additional_context,
+      //   deferred_tools_delta, mcp_instructions_delta, skill_listing,
+      //   nested_memory, todo_reminder, command_permissions
+      // すべて L3 kind=system として捕捉する。ペイロードのフィールド名は種別ごとに
+      // 異なるため、共通のテキストフィールドを優先度順に試す。
+      const a = e.attachment;
+      if (!a || !a.type) continue;
+
+      const output =
+        (typeof a.content === 'string' && a.content) ||
+        (Array.isArray(a.content) && a.content.join('\n')) ||
+        (typeof a.stdout === 'string' && a.stdout) ||
+        (Array.isArray(a.addedBlocks) && a.addedBlocks.join('\n')) ||
+        (Array.isArray(a.addedLines) && a.addedLines.join('\n')) ||
+        // 既知フィールドがすべて空ならメタ情報を JSON で残す（情報ロスを避ける §0）
+        JSON.stringify(a);
+
+      // 種別名 + hook イベント名で tool_name を一意化
+      const toolName = a.hookEvent ? `${a.type}:${a.hookEvent}` : a.type;
+
+      out.push({
+        kind: DETAIL_KIND.SYSTEM,
+        tool_name: toolName,
+        source_id: e.uuid ?? null,
+        input_text: a.command ?? a.path ?? null,
+        output_text: stripAnsi(String(output)),
+      });
+    }
+    // type === 'system' (stop_hook_summary) や queue-operation / file-history-snapshot は skip
+  }
+
+  return out;
+}
+
+/**
+ * 最後のターン（最後の user または assistant メッセージ）を返す。
+ * @param {string} transcriptPath
+ * @returns {{role: string, content: string, turn_number: number} | null}
+ */
+export function getLastTurn(transcriptPath) {
+  const turns = readTranscript(transcriptPath);
+  return turns.length > 0 ? turns[turns.length - 1] : null;
+}
+
+/**
+ * 最後の assistant ターンだけを返す。
+ * @param {string} transcriptPath
+ * @returns {{role: string, content: string, turn_number: number} | null}
+ */
+export function getLastAssistantTurn(transcriptPath) {
+  const turns = readTranscript(transcriptPath);
+  for (let i = turns.length - 1; i >= 0; i--) {
+    if (turns[i].role === 'assistant') return turns[i];
+  }
+  return null;
+}
+
+/**
+ * 最後の assistant ターンと、それに対応する直前の user ターンをペアで返す。
+ * Stop フックで L2 (bodies) に 1 往復分を保存するために使う。
+ *
+ * user メッセージには tool_result のような合成メッセージも混じるが、
+ * readTranscript() は text ブロックだけを抽出しているので、text が
+ * 空の user メッセージは自動的に除外されている（= tool_result のみの行は弾かれる）。
+ *
+ * @param {string} transcriptPath
+ * @returns {{
+ *   user: {role: string, content: string, turn_number: number} | null,
+ *   assistant: {role: string, content: string, turn_number: number} | null
+ * }}
+ */
+export function getLastTurnPair(transcriptPath) {
+  const turns = readTranscript(transcriptPath);
+  let assistantIdx = -1;
+  for (let i = turns.length - 1; i >= 0; i--) {
+    if (turns[i].role === 'assistant') {
+      assistantIdx = i;
+      break;
+    }
+  }
+  if (assistantIdx < 0) return { user: null, assistant: null };
+
+  // assistant の直前の user ターンを探す
+  let userTurn = null;
+  for (let i = assistantIdx - 1; i >= 0; i--) {
+    if (turns[i].role === 'user') {
+      userTurn = turns[i];
+      break;
+    }
+  }
+
+  return { user: userTurn, assistant: turns[assistantIdx] };
+}