throughline 0.3.17 → 0.3.19

package/README.md

@@ -178,9 +178,16 @@ Example output (real values from a running 1M-context Opus session):
 - **Line-wrap safe.** Each line is truncated to `process.stdout.columns - 1`
   before drawing, preserving ANSI color codes. The redraw cursor math cannot
   desync on narrow terminals.
-- **Resize resilient.** Column width is polled every second, so pane drags that
-  don't fire a terminal `resize` event (common in VS Code's integrated
-  terminal) still trigger a full redraw.
+- **Resize resilient via OSC 18t.** Windows ConPTY + VS Code task terminals
+  freeze `process.stdout.columns` at the PTY's initial size and never
+  propagate panel resizes into Node, so polling or `resize` events can't
+  catch them. Throughline queries the terminal itself with the CSI `18 t`
+  escape (`\x1b[18t`) every tick, parses the `\x1b[8;rows;cols t` reply off
+  stdin in raw mode, and uses the real current width for truncation. On
+  terminals that don't answer the query, the renderer falls back to
+  `process.stdout.columns → env.COLUMNS → 80`. When the width changes the
+  viewport is cleared in full (`\x1b[2J\x1b[3J\x1b[H`) before the next
+  frame so the previous, wrongly-sized frame can't stack beneath it.
 - **Per-row "last updated" stamp.** Each session row carries an 8-cell
   `just now` / `24m ago` stamp right after the session id, placed before the
   bar so narrow terminals don't truncate it. It resets to `just now` on every
@@ -256,6 +263,7 @@ entry to the `tasks` array yourself:
 | `throughline install --project`                | Register hooks in `.claude/settings.json` for this repo only |
 | `throughline uninstall`                        | Remove Throughline hooks from the settings file              |
 | `throughline monitor [--all] [--session <id>]` | Run the multi-session token monitor                          |
+| `throughline monitor --diag`                   | Dump TTY/columns/env diagnostics (for debugging monitor render bugs) |
 | `throughline detail <time>`                    | Retrieve L2 body text and L3 tool I/O for a turn (see below) |
 | `throughline save-inflight`                    | Called by `/tl` to attach an in-flight memo (stdin) to the current baton |
 | `throughline doctor`                           | Check Node version, hook registration, DB writability, PATH  |

package/package.json

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

package/src/prompt-submit.mjs

@@ -14,6 +14,7 @@
 
 import { getDb } from './db.mjs';
 import { writeBaton } from './baton.mjs';
+import { ensureMonitorTaskFile } from './vscode-task.mjs';
 import { appendFileSync, mkdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
@@ -54,6 +55,16 @@ async function main() {
   const payload = JSON.parse(raw);
   const { session_id, cwd, prompt } = payload;
 
+  // VSCode 新規プロジェクトへの tasks.json 自動プロビジョニング。
+  // SessionStart/Stop に加えここでも呼ぶことで、どれか 1 つでも発火すれば初回メッセージ送信で
+  // tasks.json が生える。冪等性は ensureMonitorTaskFile 側で保証。/tl 判定より前に置く。
+  try {
+    ensureMonitorTaskFile({ cwd: cwd ?? process.cwd(), env: process.env });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : 'unknown';
+    process.stderr.write(`[vscode-task] ${msg}\n`);
+  }
+
   if (!isBatonCommand(prompt)) {
     process.exit(0);
     return;

package/src/session-start.mjs

@@ -21,6 +21,7 @@ import { getDb } from './db.mjs';
 import { consumeBaton } from './baton.mjs';
 import { mergeSpecificPredecessor, resolveMergeTarget } from './session-merger.mjs';
 import { buildResumeContext } from './resume-context.mjs';
+import { ensureMonitorTaskFile } from './vscode-task.mjs';
 import { appendFileSync, mkdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
@@ -55,6 +56,18 @@ async function main() {
   const db = getDb();
   const now = Date.now();
 
+  // 0. VSCode で開かれた新規プロジェクトに .vscode/tasks.json を自動プロビジョニング。
+  //    Stop hook 側にも同じ呼び出しがあるが、Stop が発火しない環境（応答中断・IDE 挙動差）
+  //    でも SessionStart は必ず走るので、新規プロジェクトでの自動起動を確実化する保険。
+  //    冪等性は ensureMonitorTaskFile 側で保証されており、Stop/UserPromptSubmit と重複呼び
+  //    出しされても安全。
+  try {
+    ensureMonitorTaskFile({ cwd: projectPath, env: process.env });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : 'unknown';
+    process.stderr.write(`[vscode-task] ${msg}\n`);
+  }
+
   // 1. sessions テーブルに INSERT OR IGNORE
   db.prepare(
     `INSERT OR IGNORE INTO sessions (session_id, project_path, status, created_at, updated_at)

package/src/vscode-task.mjs

@@ -161,6 +161,37 @@ function atomicWrite(targetPath, contents) {
   renameSync(tmp, targetPath);
 }
 
+/**
+ * tasks.json を「今まさに作成/マージした」瞬間にユーザー向けへ送る通知テキスト。
+ *
+ * SessionStart / UserPromptSubmit の stdout は Claude Code に additional context として
+ * 取り込まれる。<system-reminder> で包んで Claude に「これをユーザーに伝える」ことを
+ * 明示しておくことで、新規プロジェクト初回セットアップ直後にユーザーへ
+ * 「Reload Window が必要」を即時通知できる。
+ *
+ * 通知するのは action が 'created' か 'merged' の場合のみ。既に存在した場合は
+ * セットアップ済みのため沈黙する（冪等性）。
+ */
+export function buildSetupNotice(action) {
+  if (action !== 'created' && action !== 'merged') return null;
+  return (
+    '<system-reminder>\n' +
+    'Throughline: このプロジェクトに token-monitor の自動起動設定を追加しました (.vscode/tasks.json)。\n' +
+    '今すぐ monitor を起動するには、VSCode のコマンドパレット (Ctrl+Shift+P) から\n' +
+    '  Developer: Reload Window\n' +
+    'を実行してください。次回以降はフォルダを開いた瞬間に自動起動します。\n' +
+    '\n' +
+    'このお知らせは今このプロジェクトで初回セットアップが完了したためだけに 1 度だけ流れています。\n' +
+    '必ずユーザー（あなたの対話相手）に日本語でそのまま伝えてください。\n' +
+    '</system-reminder>\n'
+  );
+}
+
+function emitSetupNotice(action) {
+  const text = buildSetupNotice(action);
+  if (text) process.stdout.write(text);
+}
+
 function emitJsoncGuidanceOnce(vscodeDir) {
   const markerPath = join(vscodeDir, JSONC_MARKER_FILENAME);
   if (existsSync(markerPath)) return;
@@ -215,6 +246,7 @@ export function ensureMonitorTaskFile(opts = {}) {
     if (!existsSync(vscodeDir)) mkdirSync(vscodeDir, { recursive: true });
     const obj = { version: '2.0.0', tasks: [buildMonitorTask(bin)] };
     atomicWrite(tasksPath, JSON.stringify(obj, null, 2) + '\n');
+    emitSetupNotice('created');
     return { action: 'created', path: tasksPath };
   }
 
@@ -243,5 +275,6 @@ export function ensureMonitorTaskFile(opts = {}) {
     tasks: [...(Array.isArray(obj.tasks) ? obj.tasks : []), buildMonitorTask(bin)],
   };
   atomicWrite(tasksPath, JSON.stringify(nextObj, null, indent) + '\n');
+  emitSetupNotice('merged');
   return { action: 'merged', path: tasksPath };
 }

package/src/vscode-task.test.mjs

@@ -10,6 +10,7 @@ import {
   detectIndent,
   hasMonitorTask,
   buildMonitorTask,
+  buildSetupNotice,
 } from './vscode-task.mjs';
 
 const VSCODE_ENV = { TERM_PROGRAM: 'vscode' };
@@ -518,3 +519,60 @@ test('ensureMonitorTaskFile: parse_error for malformed JSON', () => {
     cleanup();
   }
 });
+
+// --- buildSetupNotice ---
+
+test('buildSetupNotice: returns notice text for created', () => {
+  const text = buildSetupNotice('created');
+  assert.ok(text && text.includes('<system-reminder>'));
+  assert.ok(text.includes('Reload Window'));
+  assert.ok(text.includes('tasks.json'));
+  assert.ok(text.includes('ユーザー'));
+});
+
+test('buildSetupNotice: returns notice text for merged', () => {
+  const text = buildSetupNotice('merged');
+  assert.ok(text && text.includes('<system-reminder>'));
+  assert.ok(text.includes('Reload Window'));
+});
+
+test('buildSetupNotice: returns null for already_present (silent idempotency)', () => {
+  assert.equal(buildSetupNotice('already_present'), null);
+});
+
+test('buildSetupNotice: returns null for skipped', () => {
+  assert.equal(buildSetupNotice('skipped'), null);
+});
+
+test('buildSetupNotice: ensureMonitorTaskFile writes notice to stdout on first creation', () => {
+  const { dir, cleanup } = mkTmpCwd();
+  const captured = [];
+  const origWrite = process.stdout.write.bind(process.stdout);
+  process.stdout.write = (chunk) => {
+    captured.push(typeof chunk === 'string' ? chunk : chunk.toString('utf8'));
+    return true;
+  };
+  try {
+    const r1 = ensureMonitorTaskFile({
+      cwd: dir,
+      env: VSCODE_ENV,
+      throughlineBin: FAKE_BIN,
+    });
+    assert.equal(r1.action, 'created');
+    const r2 = ensureMonitorTaskFile({
+      cwd: dir,
+      env: VSCODE_ENV,
+      throughlineBin: FAKE_BIN,
+    });
+    assert.equal(r2.action, 'already_present');
+  } finally {
+    process.stdout.write = origWrite;
+    cleanup();
+  }
+  const joined = captured.join('');
+  assert.ok(joined.includes('<system-reminder>'), 'notice should be written on created');
+  assert.ok(joined.includes('Reload Window'));
+  // 2 回目 (already_present) では notice は出ない = created 分の 1 回のみ
+  const count = (joined.match(/<system-reminder>/g) ?? []).length;
+  assert.equal(count, 1, 'notice should be emitted exactly once (idempotency)');
+});