throughline 0.3.5 → 0.3.7

package/README.md

@@ -181,11 +181,14 @@ Example output (real values from a running 1M-context Opus session):
 - **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.
-- **Per-row "last updated" stamp.** Each session row ends with `(24m ago)` so
-  you can tell a frozen display apart from an idle session at a glance. When
-  you need more detail, `throughline doctor --session <id-prefix>` compares the
-  state file against the actual transcript JSONL and flags drift, idle time,
-  and `/clear`-induced transcript path staleness.
+- **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
+  Stop hook, so a growing stamp means the session is truly idle — not the
+  monitor stuck. When you need more detail,
+  `throughline doctor --session <id-prefix>` compares the state file against
+  the actual transcript JSONL and flags drift, idle time, and
+  `/clear`-induced transcript path staleness.
 - **State-backed usage snapshot.** When the Stop hook finishes a turn it
   persists the latest `tokens / model / contextWindowSize` back into the state
   file. The monitor prefers this snapshot over re-reading the JSONL, which
@@ -379,6 +382,13 @@ No session has touched its state file in the last 15 minutes. Send a message in
 Claude Code and the monitor should pick it up within 1 second. If it still does
 not, run `throughline doctor`.
 
+**Monitor seems stuck on the same value**
+Each session row ends with a `(Nm ago)` stamp. If it keeps growing, the session
+is idle — no assistant turn has finished. For a deeper look, run
+`throughline doctor --session <id-prefix>` to compare the state file against
+the actual transcript JSONL and flag drift, idle time, or `/clear`-induced
+transcript path staleness.
+
 **`throughline install` wrote to the wrong settings file**
 By default, Throughline installs to `~/.claude/settings.json` (user scope, applies
 to all projects). Use `--project` to scope it to the current directory's
@@ -430,13 +440,18 @@ the folder in VS Code.
 
 ## Design docs
 
-- [`docs/L1_L2_L3_REDESIGN.md`](docs/L1_L2_L3_REDESIGN.md) — **current design
+- [`docs/L1_L2_L3_REDESIGN.md`](docs/L1_L2_L3_REDESIGN.md) — **core design
   spec** for the L1/L2/L3 differential layer model (schema v4 base + v5 L3
-  classification extension). Authoritative.
-- [`docs/PUBLIC_RELEASE_PLAN.md`](docs/PUBLIC_RELEASE_PLAN.md) — public release
-  plan (CLI surface, package.json layout, § 0 fallback rule)
+  classification extension). Authoritative for the memory layering rules.
+- [`docs/INHERITANCE_ON_CLEAR_ONLY.md`](docs/INHERITANCE_ON_CLEAR_ONLY.md) —
+  design record for the `/tl` baton handoff system (schema v6–v7). Explains
+  why the current inheritance is opt-in rather than heuristic.
+- [`docs/PUBLIC_RELEASE_PLAN.md`](docs/PUBLIC_RELEASE_PLAN.md) — public
+  release plan, implementation status by version, § 0 fallback rule, and
+  remaining tasks.
 - [`docs/archive/`](docs/archive/) — superseded design documents kept for
-  historical reference (original CONCEPT, session-linking experiments, etc.)
+  historical reference (original CONCEPT, session-linking experiments,
+  pre-publish action list).
 
 ---
 

package/package.json

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

package/src/token-monitor.mjs

@@ -231,6 +231,36 @@ export function shouldForceFullRedraw(prevCols, currCols) {
   return prevCols !== currCols && currCols > 0;
 }
 
+/**
+ * 描画に使う列幅を解決する。
+ *
+ * 優先順:
+ *   1. **stdout が TTY** かつ `process.stdout.columns` が 40 以上
+ *       → その値から 1 引いたもの（末尾列での自動改行回避）
+ *   2. `process.env.COLUMNS` が 40 以上 → その値 - 1
+ *   3. それ以外 → 200 にフォールバック
+ *
+ * 非 TTY のとき columns を信用しない理由:
+ *   VSCode の `type: process` タスクは stdout を PTY ではなくパイプとして渡すため、
+ *   - 起動時の columns が undefined / 0 / 12 のような極端な値になることがある
+ *   - ターミナル panel をドラッグで広げても SIGWINCH が届かず columns が更新されない
+ *   - 結果として起動時に狭かった幅のまま永久に truncate され続ける
+ *   `isTTY` が false の時点で columns 値は信頼できない契約だと割り切り、env.COLUMNS か
+ *   固定 200 にフォールバックする。
+ *
+ * 200 固定フォールバックは、truncateToCells が 200 セル以下の実内容をそのまま通す
+ * （伸長しない）ので過大でも副作用なし。
+ */
+export function resolveColumns() {
+  if (process.stdout.isTTY) {
+    const reported = typeof process.stdout.columns === 'number' ? process.stdout.columns : 0;
+    if (reported >= 40) return reported - 1;
+  }
+  const fromEnv = Number(process.env.COLUMNS);
+  if (Number.isFinite(fromEnv) && fromEnv >= 40) return fromEnv - 1;
+  return 200;
+}
+
 function formatLine({ state, usage, isActive, now = Date.now() }) {
   const project = basename(state.projectPath || '?');
   const shortId = state.sessionId.slice(0, 8);
@@ -387,9 +417,7 @@ function renderFrame(args) {
   //   こうすれば ANSI.up(lines.length) と論理行数が物理行数と一致する。
   //   columns - 1 にしてるのはターミナル末尾列に書くと自動改行する端末があるため。
   //   truncateToCells は CJK / 絵文字を 2 セルとして正しく数える。
-  const columns = process.stdout.columns && process.stdout.columns > 10
-    ? process.stdout.columns - 1
-    : 120;
+  const columns = resolveColumns();
   const clipped = lines.map((l) => truncateToCells(l, columns));
 
   // 前フレームを消去してから再描画:
@@ -524,6 +552,7 @@ export const _internal = {
   resetRenderKeyCache,
   formatTimeAgo,
   shouldForceFullRedraw,
+  resolveColumns,
 };
 
 // --- エントリポイント自動起動 ---

package/src/token-monitor.test.mjs

@@ -15,6 +15,7 @@ const {
   formatLine,
   formatTimeAgo,
   shouldForceFullRedraw,
+  resolveColumns,
 } = _internal;
 
 // state-file は projectPath を resolve + lowercase 正規化する。
@@ -385,6 +386,64 @@ test('shouldForceFullRedraw: 片方 0 以下は false (未初期化 or 無効)',
   assert.equal(shouldForceFullRedraw(0, 80), true);
 });
 
+// ─── resolveColumns ───────────────────────────────────────────────
+
+function withStdoutState({ isTTY, columns, envColumns }, fn) {
+  const origIsTTY = process.stdout.isTTY;
+  const origColumns = process.stdout.columns;
+  const origEnv = process.env.COLUMNS;
+  try {
+    Object.defineProperty(process.stdout, 'isTTY', { value: isTTY, configurable: true, writable: true });
+    Object.defineProperty(process.stdout, 'columns', { value: columns, configurable: true, writable: true });
+    if (envColumns === undefined) delete process.env.COLUMNS;
+    else process.env.COLUMNS = envColumns;
+    return fn();
+  } finally {
+    Object.defineProperty(process.stdout, 'isTTY', { value: origIsTTY, configurable: true, writable: true });
+    Object.defineProperty(process.stdout, 'columns', { value: origColumns, configurable: true, writable: true });
+    if (origEnv === undefined) delete process.env.COLUMNS;
+    else process.env.COLUMNS = origEnv;
+  }
+}
+
+test('resolveColumns: TTY かつ columns が 40 以上 → その値 - 1', () => {
+  withStdoutState({ isTTY: true, columns: 120, envColumns: undefined }, () => {
+    assert.equal(resolveColumns(), 119);
+  });
+});
+
+test('resolveColumns: 非 TTY なら columns が大きくても信用しない (env も 200 も使う)', () => {
+  // type: process タスクで columns が 120 にセットされたが実際の幅とは連動しない、という状況。
+  // env.COLUMNS も無ければ 200 フォールバック。
+  withStdoutState({ isTTY: false, columns: 120, envColumns: undefined }, () => {
+    assert.equal(resolveColumns(), 200);
+  });
+});
+
+test('resolveColumns: TTY でも columns が小さすぎる値 (12 等) ならフォールバック 200', () => {
+  withStdoutState({ isTTY: true, columns: 12, envColumns: undefined }, () => {
+    assert.equal(resolveColumns(), 200);
+  });
+});
+
+test('resolveColumns: 非 TTY でも env.COLUMNS >= 40 があればそれを使う', () => {
+  withStdoutState({ isTTY: false, columns: undefined, envColumns: '150' }, () => {
+    assert.equal(resolveColumns(), 149);
+  });
+});
+
+test('resolveColumns: TTY で columns 未設定、env も無ければフォールバック 200', () => {
+  withStdoutState({ isTTY: true, columns: undefined, envColumns: undefined }, () => {
+    assert.equal(resolveColumns(), 200);
+  });
+});
+
+test('resolveColumns: 全てのソースが無効ならフォールバック 200', () => {
+  withStdoutState({ isTTY: false, columns: undefined, envColumns: undefined }, () => {
+    assert.equal(resolveColumns(), 200);
+  });
+});
+
 // ─── formatLine: time-ago 表示 ────────────────────────────────────
 
 test('formatLine: updatedAt から経過時間が表示される', () => {

package/src/vscode-task.mjs

@@ -109,6 +109,12 @@ export function hasMonitorTask(obj) {
  * 依存して失敗しうる。process は command を直接起動するため堅い。
  * command には Node 実行ファイルの絶対パスを入れ、args に throughline.mjs の
  * 絶対パスと 'monitor' サブコマンドを渡す。
+ *
+ * options.env.COLUMNS=200 を渡す理由:
+ *   type: 'process' では VSCode は PTY を張らず stdout をパイプするため、
+ *   子プロセスの `process.stdout.columns` が undefined か極端に小さい値になり、
+ *   モニターの幅計算が破綻する。COLUMNS env を明示しておけば token-monitor の
+ *   resolveColumns() が 200 を採用して行が「openclaw」で切れる不具合を避けられる。
  */
 export function buildMonitorTask(throughlineBin) {
   return {
@@ -117,6 +123,9 @@ export function buildMonitorTask(throughlineBin) {
     type: 'process',
     command: process.execPath,
     args: [throughlineBin, 'monitor'],
+    options: {
+      env: { COLUMNS: '200' },
+    },
     isBackground: true,
     presentation: {
       reveal: 'always',

package/src/vscode-task.test.mjs

@@ -148,6 +148,13 @@ test('buildMonitorTask: uses type=process with provided bin as args[0]', () => {
   assert.equal(task.isBackground, true);
 });
 
+test('buildMonitorTask: sets COLUMNS=200 env to work around type:process non-TTY stdout', () => {
+  const task = buildMonitorTask('/abs/bin/throughline.mjs');
+  assert.ok(task.options, 'task should carry options');
+  assert.ok(task.options.env, 'options should carry env');
+  assert.equal(task.options.env.COLUMNS, '200');
+});
+
 // --- ensureMonitorTaskFile: skip conditions ---
 
 test('ensureMonitorTaskFile: opt_out via THROUGHLINE_NO_VSCODE=1', () => {