throughline 0.1.0

package/src/cli/status.mjs

@@ -0,0 +1,41 @@
+/**
+ * throughline status — DB 統計表示
+ */
+
+import { getDb } from '../db.mjs';
+
+export async function run() {
+  const db = getDb();
+
+  const sessions = db.prepare('SELECT COUNT(*) as count FROM sessions').get();
+  const skeletons = db.prepare('SELECT COUNT(*) as count FROM skeletons').get();
+  let bodies = { count: 0 };
+  try {
+    bodies = db.prepare('SELECT COUNT(*) as count FROM bodies').get();
+  } catch {
+    // bodies テーブルは schema v4 以降。v3 DB では存在しない
+  }
+  const details = db.prepare('SELECT COUNT(*) as count FROM details').get();
+
+  const recentSessions = db.prepare(`
+    SELECT session_id, project_path, updated_at
+    FROM sessions
+    ORDER BY updated_at DESC
+    LIMIT 5
+  `).all();
+
+  console.log('throughline status\n');
+  console.log(`  sessions  : ${sessions.count}`);
+  console.log(`  skeletons : ${skeletons.count} (L1)`);
+  console.log(`  bodies    : ${bodies.count} (L2)`);
+  console.log(`  details   : ${details.count} (L3)`);
+  console.log('');
+  console.log('最近のセッション:');
+  for (const s of recentSessions) {
+    const date = new Date(s.updated_at).toLocaleString('ja-JP');
+    const shortId = s.session_id.slice(0, 8);
+    const project = s.project_path.split(/[/\\]/).pop();
+    console.log(`  ${shortId}  ${project}  ${date}`);
+  }
+  console.log('');
+}

package/src/constants.mjs

@@ -0,0 +1,16 @@
+/**
+ * 共有定数。
+ * - 複数モジュールが同じ文字列リテラルで分岐する値はここに集約する。
+ * - 値は SQL に書き込む列値とも一致させる（schema v5 details.kind）。
+ */
+
+/** L3 (details テーブル) の kind 列取り得る値 */
+export const DETAIL_KIND = Object.freeze({
+  TOOL_INPUT: 'tool_input',
+  TOOL_OUTPUT: 'tool_output',
+  SYSTEM: 'system',
+  IMAGE: 'image',
+});
+
+/** 上記の値すべての Set（未知値判定に使う） */
+export const DETAIL_KIND_VALUES = new Set(Object.values(DETAIL_KIND));

package/src/db.mjs

@@ -0,0 +1,201 @@
+/**
+ * SQLite 接続管理 — node:sqlite (Node.js v22.5+ 組み込み、依存ゼロ)
+ */
+
+import { DatabaseSync } from 'node:sqlite';
+import { mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const DB_DIR = join(homedir(), '.throughline');
+const DB_PATH = join(DB_DIR, 'throughline.db');
+const CURRENT_VERSION = 5;
+
+let _db = null;
+
+function initSchema(db) {
+  const row = db.prepare('PRAGMA user_version').get();
+  const version = row.user_version ?? 0;
+
+  // v0 → v1: 全テーブル作成
+  if (version < 1) {
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS sessions (
+        session_id   TEXT    PRIMARY KEY,
+        project_path TEXT    NOT NULL,
+        status       TEXT    NOT NULL DEFAULT 'active',
+        created_at   INTEGER NOT NULL,
+        updated_at   INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS skeletons (
+        id           INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id   TEXT    NOT NULL,
+        turn_number  INTEGER NOT NULL,
+        role         TEXT    NOT NULL,
+        summary      TEXT    NOT NULL,
+        created_at   INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS judgments (
+        id           INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id   TEXT    NOT NULL,
+        turn_number  INTEGER NOT NULL,
+        category     TEXT    NOT NULL,
+        content      TEXT    NOT NULL,
+        content_hash TEXT    NOT NULL,
+        resolved     INTEGER NOT NULL DEFAULT 0,
+        created_at   INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS details (
+        id           INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id   TEXT    NOT NULL,
+        turn_number  INTEGER,
+        tool_name    TEXT    NOT NULL,
+        input_text   TEXT,
+        output_text  TEXT,
+        token_count  INTEGER NOT NULL DEFAULT 0,
+        created_at   INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS injection_log (
+        id             INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id     TEXT    NOT NULL,
+        event_type     TEXT    NOT NULL,
+        turns_injected INTEGER NOT NULL DEFAULT 0,
+        tokens_saved   INTEGER NOT NULL DEFAULT 0,
+        created_at     INTEGER NOT NULL
+      );
+    `);
+  }
+
+  // v1 → v2: 重複排除用 UNIQUE インデックス追加
+  if (version < 2) {
+    // 先に既存の重複行を削除してからインデックスを作成
+    db.exec(`
+      DELETE FROM skeletons WHERE id NOT IN (
+        SELECT MIN(id) FROM skeletons GROUP BY session_id, turn_number, role
+      );
+      DELETE FROM judgments WHERE id NOT IN (
+        SELECT MIN(id) FROM judgments GROUP BY session_id, content_hash
+      );
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_skeletons_turn
+        ON skeletons(session_id, turn_number, role);
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_judgments_hash
+        ON judgments(session_id, content_hash);
+    `);
+  }
+
+  // v2 → v3: 記憶張り替え方式のための origin_session_id / merged_into 列追加
+  if (version < 3) {
+    // origin_session_id 列追加（デフォルト NULL、後続 UPDATE で自身の session_id をセット）
+    const skeletonCols = db.prepare('PRAGMA table_info(skeletons)').all();
+    if (!skeletonCols.some((c) => c.name === 'origin_session_id')) {
+      db.exec('ALTER TABLE skeletons ADD COLUMN origin_session_id TEXT');
+    }
+    const judgmentCols = db.prepare('PRAGMA table_info(judgments)').all();
+    if (!judgmentCols.some((c) => c.name === 'origin_session_id')) {
+      db.exec('ALTER TABLE judgments ADD COLUMN origin_session_id TEXT');
+    }
+    const detailCols = db.prepare('PRAGMA table_info(details)').all();
+    if (!detailCols.some((c) => c.name === 'origin_session_id')) {
+      db.exec('ALTER TABLE details ADD COLUMN origin_session_id TEXT');
+    }
+    const sessionCols = db.prepare('PRAGMA table_info(sessions)').all();
+    if (!sessionCols.some((c) => c.name === 'merged_into')) {
+      db.exec('ALTER TABLE sessions ADD COLUMN merged_into TEXT');
+    }
+
+    // 既存行の origin_session_id に自身の session_id をセット
+    db.exec(`
+      UPDATE skeletons SET origin_session_id = session_id WHERE origin_session_id IS NULL;
+      UPDATE judgments SET origin_session_id = session_id WHERE origin_session_id IS NULL;
+      UPDATE details   SET origin_session_id = session_id WHERE origin_session_id IS NULL;
+    `);
+
+    // 旧 UNIQUE インデックス drop + 新 UNIQUE インデックス作成（origin_session_id を含む）
+    db.exec(`
+      DROP INDEX IF EXISTS uq_skeletons_turn;
+      DROP INDEX IF EXISTS uq_judgments_hash;
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_skeletons_turn_v3
+        ON skeletons(session_id, origin_session_id, turn_number, role);
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_judgments_hash_v3
+        ON judgments(session_id, origin_session_id, content_hash);
+      CREATE INDEX IF NOT EXISTS idx_skeletons_session
+        ON skeletons(session_id, created_at);
+      CREATE INDEX IF NOT EXISTS idx_judgments_session
+        ON judgments(session_id, resolved, created_at);
+    `);
+  }
+
+  // v3 → v4: bodies テーブル追加（L2 = 会話自然言語ロスレス保存）、judgments DROP
+  if (version < 4) {
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS bodies (
+        id                INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id        TEXT    NOT NULL,
+        origin_session_id TEXT    NOT NULL,
+        turn_number       INTEGER NOT NULL,
+        role              TEXT    NOT NULL,
+        text              TEXT    NOT NULL,
+        token_count       INTEGER,
+        created_at        INTEGER NOT NULL,
+        UNIQUE(session_id, origin_session_id, turn_number, role)
+      );
+      CREATE INDEX IF NOT EXISTS idx_bodies_session_created
+        ON bodies(session_id, created_at);
+    `);
+
+    // judgments テーブルと関連インデックスを DROP
+    db.exec(`
+      DROP INDEX IF EXISTS uq_judgments_hash_v3;
+      DROP INDEX IF EXISTS uq_judgments_hash;
+      DROP INDEX IF EXISTS idx_judgments_session;
+      DROP TABLE IF EXISTS judgments;
+    `);
+  }
+
+  // v4 → v5: details テーブルに kind / source_id 列追加（L3 分離書き込み対応）
+  // - kind: 'tool_input' | 'tool_output' | 'system' | 'image'
+  // - source_id: transcript の一意 ID (tool_use.id, attachment.uuid 等)、冪等再処理のため
+  // - 既存行は kind='tool_input' (デフォルト)、source_id NULL
+  if (version < 5) {
+    const detailCols = db.prepare('PRAGMA table_info(details)').all();
+    if (!detailCols.some((c) => c.name === 'kind')) {
+      db.exec("ALTER TABLE details ADD COLUMN kind TEXT NOT NULL DEFAULT 'tool_input'");
+    }
+    if (!detailCols.some((c) => c.name === 'source_id')) {
+      db.exec('ALTER TABLE details ADD COLUMN source_id TEXT');
+    }
+    db.exec(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_details_source
+        ON details(session_id, origin_session_id, source_id)
+        WHERE source_id IS NOT NULL;
+      CREATE INDEX IF NOT EXISTS idx_details_session_kind
+        ON details(session_id, kind, created_at);
+    `);
+  }
+
+  if (version < CURRENT_VERSION) {
+    db.exec(`PRAGMA user_version = ${CURRENT_VERSION}`);
+  }
+}
+
+/**
+ * DB インスタンスを返す（シングルトン）
+ * @returns {DatabaseSync}
+ */
+export function getDb() {
+  if (_db) return _db;
+
+  mkdirSync(DB_DIR, { recursive: true });
+
+  _db = new DatabaseSync(DB_PATH);
+  _db.exec('PRAGMA journal_mode = WAL');
+  _db.exec('PRAGMA foreign_keys = ON');
+
+  initSchema(_db);
+
+  return _db;
+}

package/src/haiku-summarizer.mjs

@@ -0,0 +1,100 @@
+/**
+ * haiku-summarizer.mjs — Claude Haiku 4.5 を使った同期 L1 要約生成
+ *
+ * 呼び出し経路: Claude Max 契約前提。`claude -p --model claude-haiku-4-5-20251001`
+ * を子プロセス起動する。Anthropic API キーは使わない（Claude Code CLI が
+ * Max 契約の認証を持っている前提）。
+ *
+ * 【再帰暴走の根本対策: 隔離 cwd で spawn】
+ *   素朴に `claude -p` を spawn すると subprocess が同じ .claude/settings.json を
+ *   読んで Throughline の Stop hook を起動し、無限再帰になる。
+ *
+ *   これを物理的に不可能にするため、subprocess は Throughline の project-local
+ *   設定が見つからない空ディレクトリ（~/.throughline/haiku-workdir/）を cwd に
+ *   して起動する。Claude Code は cwd 起点で .claude/settings.json を探すので、
+ *   project-local 設定はロードされない。global (~/.claude/settings.json) のみ
+ *   適用されるが、そこに Throughline hook は置かれない運用前提。
+ *
+ *   複数プロジェクト・複数セッションで並列実行しても互いに干渉しない（各呼び出し
+ *   は独立した subprocess、ロックなし）。
+ *
+ *   さらに三重防御として env var THROUGHLINE_IN_HAIKU_SUBPROCESS=1 も設定する。
+ *   万一 global に Throughline hook が紛れ込んでも turn-processor 冒頭で exit する。
+ *
+ * 失敗時のポリシー:
+ *   1. 2 回までリトライ
+ *   2. それでも失敗したら L2 全文を L1 に入れる（情報欠損ゼロ）
+ */
+
+import { spawnSync } from 'child_process';
+import { mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const MODEL = 'claude-haiku-4-5-20251001';
+const MAX_RETRIES = 2;
+const TIMEOUT_MS = 30_000;
+const RECURSION_GUARD_ENV = 'THROUGHLINE_IN_HAIKU_SUBPROCESS';
+
+// 隔離 cwd: Throughline project-local 設定が見つからない空ディレクトリ
+const HAIKU_WORKDIR = join(homedir(), '.throughline', 'haiku-workdir');
+
+function ensureWorkdir() {
+  try {
+    mkdirSync(HAIKU_WORKDIR, { recursive: true });
+  } catch {
+    // ignore
+  }
+}
+
+/**
+ * L2 本文を約 1/5 に要約する。
+ * @param {string} l2Text ターンの会話本文（user+assistant を適当な形式で結合した文字列）
+ * @returns {{ summary: string, fromFallback: boolean }}
+ */
+export function summarizeToL1(l2Text) {
+  if (!l2Text || !l2Text.trim()) {
+    return { summary: '(no content)', fromFallback: true };
+  }
+
+  // 防御（念のため）: 自分自身が Haiku subprocess 内で呼ばれていたら再帰せず即フォールバック
+  if (process.env[RECURSION_GUARD_ENV] === '1') {
+    return { summary: l2Text, fromFallback: true };
+  }
+
+  const targetChars = Math.max(20, Math.round(l2Text.length / 5));
+  const prompt =
+    `次の日本語テキストを約${targetChars}文字に要約してください。` +
+    `固有名詞・数値・因果関係を優先して残し、枝葉は落としてください。` +
+    `要約文だけを出力し、前置きや説明は不要です。`;
+
+  // child_process に渡す env: 親の env を継承しつつ再帰ガードをセット
+  const childEnv = { ...process.env, [RECURSION_GUARD_ENV]: '1' };
+
+  // 隔離 cwd を準備（project-local .claude/settings.json が見えない場所）
+  ensureWorkdir();
+
+  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+    try {
+      const result = spawnSync('claude', ['-p', '--model', MODEL, prompt], {
+        input: l2Text,
+        encoding: 'utf8',
+        timeout: TIMEOUT_MS,
+        shell: process.platform === 'win32', // Windows は claude.cmd ラッパー
+        env: childEnv,
+        cwd: HAIKU_WORKDIR, // ← これが再帰防止の本丸
+      });
+
+      if (result.status === 0 && result.stdout) {
+        const summary = result.stdout.trim();
+        if (summary) return { summary, fromFallback: false };
+      }
+      // status != 0 や空出力は失敗とみなしてリトライ
+    } catch {
+      // spawn 失敗 (ENOENT 等) もリトライ
+    }
+  }
+
+  // 全リトライ失敗 → L2 全文をそのまま L1 に（情報欠損ゼロ）
+  return { summary: l2Text, fromFallback: true };
+}

package/src/resume-context.mjs

@@ -0,0 +1,148 @@
+/**
+ * resume-context.mjs — L1+L2 の再注入テキストを組み立てる共有モジュール
+ *
+ * 呼び出し元:
+ *   - session-start.mjs (isInheritance=true, 引き継ぎヘッダ)
+ *
+ * 新設計（schema v4）:
+ *   - 直近 N=20 ターンは bodies から L2 全文を注入
+ *   - それ以前は skeletons から L1 要約のみ注入
+ *   - 各行頭に [HH:MM:SS] 時刻プレフィックス（bodies.created_at ベース、DB 永続）
+ *   - 末尾に /sc-detail <時刻> ガイドを追記
+ *   - judgments セクションは廃止
+ *   - 現セッションのターンは注入しない（Claude Code 本体のコンテキストに既にあるため）
+ */
+
+const N_RECENT_L2 = 20;
+
+const RESUME_HEADER_TEMPLATE = (turnCount) =>
+  `## Throughline: セッション記憶（${turnCount} ターン引き継ぎ）\n` +
+  `**[Throughline] 前セッションの記憶を引き継ぎました。応答の冒頭で「前の記憶を ${turnCount} ターン引き継ぎました」とユーザーに報告してください。**`;
+
+const NORMAL_HEADER = '## Throughline: セッション記憶';
+
+const FOOTER_GUIDE =
+  '---\n' +
+  '**[Claude 向け — 記憶の使い方]**\n' +
+  '上の L1 要約や L2 本文を読んで「具体的なコマンドやツール出力、ファイル内容を確認したい」と感じたら、' +
+  '推測せずに **Bash ツールで `throughline detail <時刻>` を実行** して L3（ツール入出力・hook 出力）を取得してください。\n' +
+  '- 単一時刻: `throughline detail 14:23:05`\n' +
+  '- 時刻範囲: `throughline detail 14:23-14:30`\n' +
+  '\n' +
+  '返る内容: 指定ターンの L2 会話本文 + L3（tool_input / tool_output / system 別にグループ化）。\n' +
+  'ユーザーに「詳細を見せて」と言われた時だけでなく、**ユーザー発言の文脈が過去ターンに依存しているのに L1/L2 だけでは情報不足だと判断した時**に、Claude 自身の判断で呼び出して構いません。';
+
+/**
+ * Unix ms を HH:MM:SS 形式に変換する。
+ */
+function formatTime(unixMs) {
+  const d = new Date(unixMs);
+  const hh = String(d.getHours()).padStart(2, '0');
+  const mm = String(d.getMinutes()).padStart(2, '0');
+  const ss = String(d.getSeconds()).padStart(2, '0');
+  return `${hh}:${mm}:${ss}`;
+}
+
+/**
+ * 本文を 1 行にまとめる（改行は空白に畳む）。
+ */
+function flattenText(text) {
+  if (!text) return '';
+  return text.replace(/\n+/g, ' ').trim();
+}
+
+/**
+ * L1+L2 注入テキストを組み立てる。
+ *
+ * @param {import('node:sqlite').DatabaseSync} db
+ * @param {{ sessionId: string, isInheritance: boolean, excludeOriginId?: string | null }} params
+ *        sessionId: 合流先 session_id (merge target)
+ *        excludeOriginId: 注入対象から除外する origin_session_id（= 現セッションの origin）
+ *                         指定すると「前任チェーンのターンのみ」を注入する
+ * @returns {string | null}
+ */
+export function buildResumeContext(db, { sessionId, isInheritance, excludeOriginId = null }) {
+  if (!sessionId) return null;
+
+  const hasExclude = Boolean(excludeOriginId);
+
+  // 直近 N 件の bodies を取得
+  const bodiesQuery = hasExclude
+    ? `SELECT origin_session_id, turn_number, role, text, created_at
+       FROM bodies
+       WHERE session_id = ? AND origin_session_id != ?
+       ORDER BY created_at DESC
+       LIMIT ?`
+    : `SELECT origin_session_id, turn_number, role, text, created_at
+       FROM bodies
+       WHERE session_id = ?
+       ORDER BY created_at DESC
+       LIMIT ?`;
+
+  const limitRows = N_RECENT_L2 * 2; // user/assistant の 2 ロール分
+
+  let bodyRowsDesc = [];
+  try {
+    bodyRowsDesc = hasExclude
+      ? db.prepare(bodiesQuery).all(sessionId, excludeOriginId, limitRows)
+      : db.prepare(bodiesQuery).all(sessionId, limitRows);
+  } catch {
+    // bodies テーブル未作成（v3 DB）の場合は空
+    bodyRowsDesc = [];
+  }
+  const bodyRows = bodyRowsDesc.reverse(); // ASC に戻す
+
+  // 古い側の L1（bodies に既に含まれるターンを除いたもの）を skeletons から取得
+  const bodySet = new Set(
+    bodyRows.map((r) => `${r.origin_session_id}\x00${r.turn_number}`),
+  );
+
+  const skelQuery = hasExclude
+    ? `SELECT origin_session_id, turn_number, role, summary, created_at
+       FROM skeletons
+       WHERE session_id = ? AND origin_session_id != ?
+       ORDER BY created_at ASC`
+    : `SELECT origin_session_id, turn_number, role, summary, created_at
+       FROM skeletons
+       WHERE session_id = ?
+       ORDER BY created_at ASC`;
+
+  const allSkel = hasExclude
+    ? db.prepare(skelQuery).all(sessionId, excludeOriginId)
+    : db.prepare(skelQuery).all(sessionId);
+
+  const l1Rows = allSkel.filter(
+    (s) => !bodySet.has(`${s.origin_session_id}\x00${s.turn_number}`),
+  );
+
+  if (bodyRows.length === 0 && l1Rows.length === 0) {
+    return null;
+  }
+
+  const turnCount = bodyRows.length + l1Rows.length;
+  const header = isInheritance ? RESUME_HEADER_TEMPLATE(turnCount) : NORMAL_HEADER;
+  const lines = [header];
+
+  if (l1Rows.length > 0) {
+    lines.push('');
+    lines.push('### それ以前の要約 (L1)');
+    for (const r of l1Rows) {
+      if (!r.summary || r.summary === '(no content)') continue;
+      lines.push(`[${formatTime(r.created_at)}] ${flattenText(r.summary)}`);
+    }
+  }
+
+  if (bodyRows.length > 0) {
+    lines.push('');
+    lines.push('### 直近のターン履歴 (L2)');
+    for (const r of bodyRows) {
+      if (!r.text) continue;
+      lines.push(`[${formatTime(r.created_at)}] [${r.role}]: ${r.text}`);
+    }
+  }
+
+  lines.push('');
+  lines.push(FOOTER_GUIDE);
+
+  return lines.join('\n');
+}