throughline 0.10.5 → 0.10.7

package/CHANGELOG.md

@@ -10,6 +10,24 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.10.7] — 2026-09-01
+
+### Added
+
+- `throughline latest-session --project <absolute-path> --json`で、指定した
+  projectだけの直近session IDをread-onlyで取得できるようにした。
+  BellTeamのような外部ランチャーは、別projectの記憶を混ぜずに既存の
+  `handoff-context`境界へ接続できる。
+
+## [0.10.6] — 2026-09-01
+
+### Fixed
+
+- Document the one-time official npm bootstrap required when upgrading from
+  v0.10.4 or earlier, whose CLI predates `throughline self-update`. Once the
+  current CLI is installed, all later updates continue through the single
+  `throughline self-update` entry.
+
 ## [0.10.5] — 2026-09-01
 
 ### Added
@@ -1361,7 +1379,9 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.5...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.7...HEAD
+[0.10.7]: https://github.com/kitepon/Throughline/compare/v0.10.6...v0.10.7
+[0.10.6]: https://github.com/kitepon/Throughline/compare/v0.10.5...v0.10.6
 [0.10.5]: https://github.com/kitepon/Throughline/compare/v0.10.4...v0.10.5
 [0.10.4]: https://github.com/kitepon/Throughline/compare/v0.10.3...v0.10.4
 [0.10.3]: https://github.com/kitepon/Throughline/compare/v0.10.2...v0.10.3

package/README.ja.md

@@ -375,6 +375,10 @@ Throughline state をまだ書いていない現在セッションも表示で
 | `throughline install --project` | 現リポジトリの `.claude/settings.json` だけに hook を登録 |
 | `throughline self-update [--json]` | 公式npm package更新、公開PATHがその新CLI・versionを指すことの確認、製品所有連携の再適用、既存DB migration、公開diagnosticsの確認までを一回で実行 |
 | `throughline uninstall` | hook を削除 |
+
+v0.10.4以前には `self-update` が存在しない。該当版からの初回だけ
+`npm install --global throughline@latest` を実行し、続けて
+`throughline self-update` を実行する。以後の更新は `throughline self-update` だけで完結する。
 | `throughline monitor` | マルチセッション監視を起動 |
 | `throughline monitor --diag` | TTY/columns/env 診断ダンプ (描画バグ切り分け用) |
 | `throughline detail <時刻>` | あるターンの L2 本文と L3 ツール I/O を取得 (Claude が使う) |
@@ -387,6 +391,7 @@ Throughline state をまだ書いていない現在セッションも表示で
 | `throughline runtime-errors diagnostics --json` | collection/store状態をpathやraw errorなしで診断 |
 | `throughline handoff-preview --session <id>` | Codex 向け `throughline_handoff` JSON projection を表示 |
 | `throughline handoff-context --session <id> --json` | SessionStart と同じ引き継ぎ文脈を versioned JSON で取得。記憶行の `session_id` と `sessions.merged_into` は変更せず、同一端末内の別ベンダーランチャーから使える |
+| `throughline latest-session --project <absolute-path> --json` | 指定した1プロジェクトだけを対象に直近セッションIDを読み取る。既存DBをread-onlyで開き、記録がなければ`empty`を返す |
 | `throughline grok-continue --session <id>` | handoff-context を初手 user 文にした対話 Grok 席を立てる。cwd は源の `project_path`。ready でなければ spawn しない。`--rules` なし。macOS Terminal のみ |
 | `throughline codex-sidecar-diagnostics` | この project の `codex-sidecar` diagnostics status を確認 |
 | `throughline codex-sidecar-dry-run` | App Server を呼ばずに read-only sidecar request を正規化表示 |

package/README.md

@@ -817,7 +817,7 @@ entry to the `tasks` array yourself:
 
 ## Commands
 
-**The current release is v0.10.5.** Throughline supports Claude Code, Codex,
+**The current release is v0.10.7.** Throughline supports Claude Code, Codex,
 Grok, and Cursor as documented host adapters. The versioned, read-only
 `handoff-context` boundary opens only an existing database and leaves baton
 state, session ownership, and memory rows unchanged. Factory diagnostics,
@@ -830,6 +830,10 @@ under the same explicit-failure and local-only contracts.
 | `throughline install --project`                | Register Claude hooks/slash commands in this repo only       |
 | `throughline self-update [--json]`             | Update the official npm package, verify that public PATH resolves to that new CLI/version, reapply product-owned integrations, migrate an existing database, and verify public diagnostics in one call |
 | `throughline uninstall`                        | Remove Throughline-managed Claude hooks/slash commands, only the Throughline-managed Codex hook, and the `$throughline` Codex skill |
+
+Versions before v0.10.5 do not contain `self-update`. Upgrade those versions
+once with `npm install --global throughline@latest`, then run
+`throughline self-update`. Later updates use `throughline self-update` alone.
 | `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) |
@@ -852,6 +856,7 @@ under the same explicit-failure and local-only contracts.
 | `throughline runtime-errors compact --json`    | Remove only acknowledged, resolved aggregates after retention; open or unacknowledged records remain |
 | `throughline handoff-preview --session <id>`   | Print a Codex-facing `throughline_handoff` JSON projection    |
 | `throughline handoff-context --session <id> --json` | Print the exact SessionStart inheritance context as versioned JSON without moving memory rows or changing `sessions.merged_into`; intended for local launchers that need portable cross-harness context |
+| `throughline latest-session --project <absolute-path> --json` | Read the latest session id strictly scoped to one project; opens the existing database read-only and returns `empty` when the project has no captured session |
 | `throughline grok-continue --session <id>` | Spawn a person-facing Grok seat whose first user text is the handoff-context body. cwd is the source session `project_path`. Does not spawn without ready context. No `--rules`. macOS Terminal only |
 | `throughline codex-capture --codex-thread-id <id>` | Capture active Codex rollout turns into a `codex:<thread_id>` DB session |
 | `throughline codex-summarize --session codex:<id>` | Summarize captured Codex L2 into L1 with the Codex CLI backend |

package/bin/throughline.mjs

@@ -12,6 +12,7 @@
  *   throughline recall --l2|--l1 # 注入案内から辿る pull 用 read-only 記憶取得
  *   throughline handoff-preview # Codex-facing throughline_handoff JSON preview
  *   throughline handoff-context --session <id> --json # Read-only inheritance context JSON
+ *   throughline latest-session --project <path> --json # Latest session strictly scoped to one project
  *   throughline grok-continue --session <id> # Spawn a Grok seat whose first user text is handoff-context
  *   throughline auditor-context --json # Read-only bounded auditor context JSON
  *   throughline factory-diagnostics --json # Native factory read-only readiness JSON
@@ -85,6 +86,11 @@ switch (cmd) {
     if (exitCode !== 0) process.exitCode = exitCode;
     break;
   }
+  case 'latest-session': {
+    const exitCode = (await import('../src/cli/latest-session.mjs')).run(rest);
+    if (exitCode !== 0) process.exitCode = exitCode;
+    break;
+  }
   case 'grok-continue': {
     const exitCode = (await import('../src/cli/grok-continue.mjs')).run(rest);
     if (exitCode !== 0) process.exitCode = exitCode;
@@ -233,6 +239,8 @@ Usage:
   throughline handoff-context --session <id> --json
                               Print the exact inheritance context without
                               changing database ownership
+  throughline latest-session --project <absolute-path> --json
+                              Read the latest session id for exactly one project
   throughline grok-continue --session <id>
                               Spawn a person-facing Grok seat whose first
                               user text is the handoff-context body. Does not

package/docs/04_public_release_plan.md

@@ -6,7 +6,7 @@
 
 ## 現行状態
 
-- release candidateのpackage版は `0.10.5`。tagとnpmの公開確認はpublish後に行う。
+- release candidateのpackage版は `0.10.7`。tagとnpmの公開確認はpublish後に行う。
 - Claude Code、Codex、Grok、Cursorをfirst-class hostとして扱う。
 - 現行DB schemaはv9。schemaの正本は [src/db.mjs](../src/db.mjs) の
   `CURRENT_VERSION`、二相handoffの判断は
@@ -29,6 +29,10 @@ Throughline は次の入口を自分で所有し、dotagentsが無くても利
 | 復旧 | READMEのTroubleshootingと、診断が返す明示的な修復手順 |
 | 更新 | `throughline self-update`。公式package更新、更新先global rootと公開PATHが同じ新CLI・versionを指すことの確認、host配線の再適用、既存DB migration、公開diagnosticsの`ready`確認までを一回で行う |
 | 削除 | `throughline uninstall`。Throughline管理面だけを除去する |
+
+v0.10.4以前からの初回更新だけは、その版に `self-update` が無いため
+`npm install --global throughline@latest` の後に `throughline self-update` を実行する。
+v0.10.5以降は `throughline self-update` だけを公開更新入口とする。
 | release判断 | この文書のrelease gateと `scripts/verify-release-commit.mjs` |
 
 dotagentsは工場への配線と統合結果を所有するが、ThroughlineのDB、schema、migration、

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-    "version": "0.10.5",
+    "version": "0.10.7",
     "type": "module",
     "description": "Persistent memory hooks for Claude Code, Codex, Grok, and Cursor (/clear-safe context compression)",
     "keywords": [

package/src/cli/help.test.mjs

@@ -52,6 +52,7 @@ test('CLI help exposes guided Codex handoff and guarded execute semantics', () =
   assert.match(result.stdout, /--open-host auto\|desktop\|vscode\|cli\|none/);
   assert.match(result.stdout, /throughline trim --execute/);
   assert.match(result.stdout, /throughline handoff-context --session <id> --json/);
+  assert.match(result.stdout, /throughline latest-session --project <absolute-path> --json/);
   assert.match(result.stdout, /without\s+changing database ownership/);
   assert.match(result.stdout, /injectable DB memory/);
   assert.match(result.stdout, /matching/);
@@ -77,4 +78,5 @@ test('CLI help Codex commands are dispatchable', () => {
 test('CLI help exposes the dispatchable read-only handoff context boundary', () => {
   const bin = readFileSync(BIN_PATH, 'utf8');
   assert.match(bin, /case 'handoff-context':/);
+  assert.match(bin, /case 'latest-session':/);
 });

package/src/cli/latest-session.mjs

@@ -0,0 +1,70 @@
+import { DatabaseSync } from 'node:sqlite';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+
+import { sameProjectPath } from '../project-path.mjs';
+
+export const LATEST_SESSION_SCHEMA = 'throughline.latest_session.v1';
+
+export function parseArgs(argv = []) {
+  if (
+    argv.length !== 3 ||
+    argv[0] !== '--project' ||
+    typeof argv[1] !== 'string' ||
+    argv[1].length === 0 ||
+    argv[2] !== '--json'
+  ) {
+    throw new TypeError('usage error');
+  }
+  return { projectPath: resolve(argv[1]) };
+}
+
+export function findLatestSession(projectPath, {
+  dbPath = join(homedir(), '.throughline', 'throughline.db'),
+} = {}) {
+  if (!existsSync(dbPath)) return null;
+
+  const db = new DatabaseSync(dbPath, { readOnly: true });
+  try {
+    const rows = db.prepare(
+      `SELECT session_id, project_path, updated_at
+       FROM sessions
+       ORDER BY updated_at DESC`,
+    ).all();
+    return rows.find((row) => sameProjectPath(row.project_path, projectPath)) ?? null;
+  } finally {
+    db.close();
+  }
+}
+
+export function run(argv = [], {
+  stdout = process.stdout,
+  stderr = process.stderr,
+  lookup = findLatestSession,
+} = {}) {
+  let projectPath;
+  try {
+    ({ projectPath } = parseArgs(argv));
+  } catch {
+    stderr.write('Usage: throughline latest-session --project <absolute-path> --json\n');
+    return 2;
+  }
+
+  let session;
+  try {
+    session = lookup(projectPath);
+  } catch {
+    stderr.write('Throughline latest session could not be read.\n');
+    return 1;
+  }
+
+  stdout.write(`${JSON.stringify({
+    schema: LATEST_SESSION_SCHEMA,
+    status: session ? 'ready' : 'empty',
+    projectPath,
+    sessionId: session?.session_id ?? null,
+    updatedAt: session?.updated_at ?? null,
+  })}\n`);
+  return 0;
+}

package/src/cli/latest-session.test.mjs

@@ -0,0 +1,64 @@
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import test from 'node:test';
+
+import { findLatestSession, parseArgs, run } from './latest-session.mjs';
+
+function output() {
+  let value = '';
+  return {
+    stream: { write(chunk) { value += chunk; } },
+    read() { return value; },
+  };
+}
+
+test('project pathを絶対化して受け取る', () => {
+  assert.equal(parseArgs(['--project', '.', '--json']).projectPath, process.cwd());
+  assert.throws(() => parseArgs(['--project', '.']));
+});
+
+test('同じprojectの最新sessionだけを返す', () => {
+  const root = mkdtempSync(join(tmpdir(), 'throughline-latest-session-'));
+  const dbPath = join(root, 'throughline.db');
+  const db = new DatabaseSync(dbPath);
+  db.exec('CREATE TABLE sessions (session_id TEXT, project_path TEXT, updated_at TEXT)');
+  db.prepare('INSERT INTO sessions VALUES (?, ?, ?)').run('other-new', join(root, 'other'), '2026-09-01T03:00:00Z');
+  db.prepare('INSERT INTO sessions VALUES (?, ?, ?)').run('same-old', join(root, 'bot'), '2026-09-01T01:00:00Z');
+  db.prepare('INSERT INTO sessions VALUES (?, ?, ?)').run('same-new', join(root, 'bot'), '2026-09-01T02:00:00Z');
+  db.close();
+
+  try {
+    assert.equal(findLatestSession(join(root, 'bot'), { dbPath }).session_id, 'same-new');
+    assert.equal(findLatestSession(join(root, 'missing'), { dbPath }), null);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test('readyとemptyをJSONで返す', () => {
+  const stdout = output();
+  const stderr = output();
+  assert.equal(run(['--project', '/bots/a', '--json'], {
+    stdout: stdout.stream,
+    stderr: stderr.stream,
+    lookup: () => ({ session_id: 'claude:abc', updated_at: 'now' }),
+  }), 0);
+  assert.deepEqual(JSON.parse(stdout.read()), {
+    schema: 'throughline.latest_session.v1',
+    status: 'ready',
+    projectPath: '/bots/a',
+    sessionId: 'claude:abc',
+    updatedAt: 'now',
+  });
+
+  const empty = output();
+  assert.equal(run(['--project', '/bots/b', '--json'], {
+    stdout: empty.stream,
+    stderr: stderr.stream,
+    lookup: () => null,
+  }), 0);
+  assert.equal(JSON.parse(empty.read()).status, 'empty');
+});