throughline 0.10.1 → 0.10.2

package/CHANGELOG.md

@@ -10,6 +10,20 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.10.2] — 2026-08-24
+
+### Changed
+
+- 挙動不変のOS/harness層集約リファクタ（harness用語統一campaignの分離規約）:
+  - LOCALAPPDATA / XDG_CONFIG_HOME / XDG_STATE_HOME のベースディレクトリ組み立てを
+    新設`src/os/app-dirs.mjs`へ一本化（runtime-error-store / completed-turn-receipts
+    に3重実装されていた）。
+  - hostリテラル比較（`'claude'`／`'codex'`）6ファイルを`src/hosts/identity.mjs`の
+    定数importへ統一し、「識別の唯一の正本」宣言と実装を一致させた。
+  - codex-auto-refreshの独自パス正規化を`src/os/paths.mjs`の
+    `foldPathCaseForPlatform`へ、codex-sidecarのwin32判定を同`isWin32Platform`へ委譲。
+  - `hosts/identity.mjs`の分類語をvendorからharnessへ更新（用語のみ）。
+
 ## [0.10.1] — 2026-08-23
 
 ### Changed

package/README.ja.md

@@ -390,7 +390,7 @@ throughline handoff-context --session codex:<thread-id> --json
 成功時の`throughline.handoff_context.v1`は`schema`、`status`、`sessionId`、`context`だけを返す。
 `context`はSessionStartと同じ予算付き継承文脈で、DB作成・migration・baton消費・session merge・
 latest session推測・`sessions.merged_into`変更・L1/L2/L3 rowの所属変更は行わない。AItermは任意の
-別vendor portable forkでこの境界を使う。Observer feedはcompleted-turn projectionであり代替ではない。
+別harness portable forkでこの境界を使う。Observer feedはcompleted-turn projectionであり代替ではない。
 
 スラッシュコマンド (Claude Code 内でユーザーが叩く):
 

package/README.md

@@ -834,7 +834,7 @@ local-only contracts.
 | `throughline runtime-errors reopen <fingerprint> --json` | Explicitly reopen a resolved aggregate without fabricating a new occurrence |
 | `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-vendor context |
+| `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 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 |
@@ -872,7 +872,7 @@ The successful `throughline.handoff_context.v1` object contains only `schema`,
 inheritance text used by SessionStart. The command does not create or migrate a
 database, consume a baton, merge sessions, infer a latest session, change
 `sessions.merged_into`, or reassign L1/L2/L3 rows. AIterm uses this boundary for
-its optional cross-vendor portable fork; the Observer feed is a separate
+its optional cross-harness portable fork; the Observer feed is a separate
 completed-turn projection and is not a substitute.
 
 Slash commands (invoked by the user in Claude Code):

package/docs/16_readonly_handoff_context_plan.md

@@ -4,14 +4,14 @@
 
 通常 handoff が使う `buildBudgetedResumeContext` の出力を、DB 所有権を変えずにローカルプログラムが
 取得できる read-only CLI として公開する。最初の consumer は AIterm の portable fork だが、I/F は
-特定 consumer や vendor に依存させない。
+特定 consumer や harness に依存させない。
 
 実行 ToDo、依存、状態、完了証拠の正本は Lattice plan `readonly-handoff-context` とする。
 
 ## 完了
 
 2026-08-04に`throughline@0.9.0`としてnpm、tag、GitHub Release、global installまで公開した。
-focused契約testと全回帰は729 pass／1 skip／0 fail。AIterm v0.23.0の代表cross-vendor smokeでは
+focused契約testと全回帰は729 pass／1 skip／0 fail。AIterm v0.23.0の代表cross-harness smokeでは
 Codex source memoryをClaudeへ注入し、前後でsource session、`sessions.merged_into`、L1/L2/L3 row所属が
 完全一致することを確認した。公開後の現行ドキュメント全域監査は、Latticeの終端ToDoを再openして
 README、作業者入口、配布Codex skill、docs索引、計画、CHANGELOGへ同期した。変更Markdownの

package/package.json

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

package/src/auditor-context.mjs

@@ -3,7 +3,7 @@ import { homedir } from 'node:os';
 import { isAbsolute, join, resolve, sep } from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
 import { buildBodyRowsFromActiveTurns } from './codex-capture.mjs';
-import { isCodexSessionId } from './hosts/identity.mjs';
+import { CLAUDE_HOST, CODEX_HOST, isCodexSessionId } from './hosts/identity.mjs';
 import { parseCodexRolloutFile } from './codex-rollout-memory.mjs';
 import { getLogicalTurnGroups } from './transcript-reader.mjs';
 import { hashAuditorBody, normalizeAuditorBody } from './body-digest.mjs';
@@ -24,7 +24,7 @@ export function defaultAuditorContextDbPath() {
 export function deriveAuditorFreshnessExpectation({ host, transcriptPath, sessionId } = {}) {
   assertNonEmptyString(transcriptPath, 'transcriptPath');
   assertNonEmptyString(sessionId, 'sessionId');
-  if (host === 'claude') {
+  if (host === CLAUDE_HOST) {
     const latest = getLogicalTurnGroups(transcriptPath).at(-1);
     if (!latest) return null;
     return {
@@ -34,7 +34,7 @@ export function deriveAuditorFreshnessExpectation({ host, transcriptPath, sessio
       expectedAssistantSha256: hashAuditorBody(latest.representative.content),
     };
   }
-  if (host === 'codex') {
+  if (host === CODEX_HOST) {
     const parsed = parseCodexRolloutFile(transcriptPath, { includeInFlightTurn: false });
     const rows = buildBodyRowsFromActiveTurns(parsed.activeTurns, { sessionId, now: 0 });
     const latestTurnNumber = rows.reduce((max, row) => Math.max(max, row.turnNumber), 0);

package/src/cli/auditor-context.mjs

@@ -1,3 +1,4 @@
+import { CLAUDE_HOST, CODEX_HOST } from '../hosts/identity.mjs';
 import {
   AUDITOR_CONTEXT_SCHEMA,
   deriveAuditorFreshnessExpectation,
@@ -53,7 +54,7 @@ export function parseArgs(argv = []) {
     else if (arg === '--max-body-chars') out.maxBodyChars = parsePositiveInteger(value);
     else if (arg === '--max-total-chars') out.maxTotalChars = parsePositiveInteger(value);
     else if (arg === '--db') out.dbPath = value;
-    else if (arg === '--host' && (value === 'claude' || value === 'codex')) out.host = value;
+    else if (arg === '--host' && (value === CLAUDE_HOST || value === CODEX_HOST)) out.host = value;
     else if (arg === '--transcript') out.transcriptPath = value;
     else throw new TypeError('unknown option');
   }

package/src/cli/doctor.mjs

@@ -14,6 +14,7 @@
  */
 
 import { existsSync, accessSync, readFileSync, constants, readdirSync, statSync } from 'node:fs';
+import { CODEX_HOST } from '../hosts/identity.mjs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { execSync } from 'node:child_process';
@@ -302,9 +303,9 @@ function runTrimDiagnosis(
 ) {
   const info = describeTrimHost(host);
   const codexIdentity =
-    info.host === 'codex' ? resolveCodexThreadIdentity({ codexThreadId: null }, env) : null;
+    info.host === CODEX_HOST ? resolveCodexThreadIdentity({ codexThreadId: null }, env) : null;
   const hostPrimitiveDiagnosis =
-    info.host === 'codex' ? readCodexHostPrimitiveDiagnosis({ env, auditRunner }) : null;
+    info.host === CODEX_HOST ? readCodexHostPrimitiveDiagnosis({ env, auditRunner }) : null;
   console.log(`${BOLD}[Trim]${RESET}\n`);
   console.log(`  host:                  ${info.host}`);
   console.log(`  default keep-recent:   ${DEFAULT_TRIM_KEEP_RECENT}`);
@@ -330,19 +331,19 @@ function runTrimDiagnosis(
   }
   console.log('');
   console.log('  dry-run command:');
-  if (info.host === 'codex' && !codexIdentity?.codexThreadId) {
+  if (info.host === CODEX_HOST && !codexIdentity?.codexThreadId) {
     console.log('    throughline trim --dry-run --host codex --codex-thread-id <id>');
     console.log('    throughline trim --preflight --host codex --codex-thread-id <id>');
-  } else if (info.host === 'codex') {
+  } else if (info.host === CODEX_HOST) {
     console.log('    throughline trim --dry-run --host codex');
     console.log('    throughline trim --preflight --host codex');
   } else {
     console.log(`    throughline trim --dry-run --host ${info.host}`);
   }
-  if (info.host === 'codex') {
+  if (info.host === CODEX_HOST) {
     console.log('    throughline trim --execute --host codex');
   }
-  if (info.host === 'codex') {
+  if (info.host === CODEX_HOST) {
     const sessionId = codexIdentity?.codexThreadId
       ? `codex:${codexIdentity.codexThreadId}`
       : 'codex:<thread-id>';

package/src/cli/trim.mjs

@@ -1,4 +1,5 @@
 import { runCodexTrimExecution, runCodexTrimPreflight } from '../codex-app-server.mjs';
+import { CODEX_HOST } from '../hosts/identity.mjs';
 import {
   buildCodexRolloutTrimSource,
   parseCodexRolloutFile,
@@ -122,7 +123,7 @@ export async function run(args) {
   const inflightMemo = parsed.memoStdin ? await readStdin() : null;
   const db = getDb();
   const trimSource =
-    parsed.host === 'codex' && parsed.codexThreadId
+    parsed.host === CODEX_HOST && parsed.codexThreadId
       ? buildCodexRolloutTrimSource({
           threadId: parsed.codexThreadId,
           projectPath: process.cwd(),
@@ -376,7 +377,7 @@ async function runPreflight(parsed, plan) {
 }
 
 function validateCodexAction(parsed, plan, action) {
-  if (parsed.host !== 'codex') {
+  if (parsed.host !== CODEX_HOST) {
     return {
       status: `${action}-refused`,
       reason: `${action}_requires_codex_host`,

package/src/codex-auto-refresh.mjs

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir, platform } from 'node:os';
+import { foldPathCaseForPlatform } from './os/paths.mjs';
+import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 
 import { runCodexTrimExecution } from './codex-app-server.mjs';
@@ -509,8 +510,7 @@ function normalizeProjectPath(value) {
   if (typeof value !== 'string' || value.length === 0) return '';
   let result = resolve(value).replace(/\\/g, '/');
   if (result.length > 1 && result.endsWith('/')) result = result.slice(0, -1);
-  if (platform() === 'win32') result = result.toLowerCase();
-  return result;
+  return foldPathCaseForPlatform(result);
 }
 
 function numberOrNull(value) {

package/src/codex-sidecar.mjs

@@ -1,4 +1,5 @@
 import { spawnPortableSync } from './os/portable-spawn-sync.mjs';
+import { isWin32Platform } from './os/paths.mjs';
 
 export const CODEX_SIDECAR_WORKFLOWS = Object.freeze([
   'review',
@@ -23,7 +24,7 @@ function resolveCommand({ command, env }) {
 }
 
 export function shouldShellWrapSidecarCommand(platform = process.platform) {
-  return platform === 'win32';
+  return isWin32Platform(platform);
 }
 
 export function runCodexSidecarCommand(command, args, options = {}) {

package/src/completed-turn-receipts.mjs

@@ -1,4 +1,5 @@
 import { createHash, randomBytes } from 'node:crypto';
+import { CLAUDE_HOST } from './hosts/identity.mjs';
 import {
   chmodSync,
   lstatSync,
@@ -8,12 +9,12 @@ import {
   rmSync,
   writeFileSync,
 } from 'node:fs';
-import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
 import { hashAuditorBody } from './body-digest.mjs';
 import { normalizeProjectPathForCompare } from './project-path.mjs';
 import { applyAndVerifyWindowsAcl, isWindows, verifyWindowsAcl } from './os/windows-acl.mjs';
+import { windowsLocalAppData, xdgStateHome } from './os/app-dirs.mjs';
 
 export const COMPLETED_TURN_RECEIPT_STORE_SCHEMA = 'throughline.completed_turn_receipts.v1';
 export const COMPLETED_TURN_RECEIPT_SCHEMA_VERSION = '1.0';
@@ -24,11 +25,10 @@ const PRIVATE_DIRECTORY_CAPABILITY = Symbol('throughline.completed-turn-receipt-
 
 export function defaultCompletedTurnReceiptStorePath(projectSha256, env = process.env) {
   if (!isSha256(projectSha256)) throw new TypeError('projectSha256 must be a SHA-256 digest');
-  const home = env.HOME || env.USERPROFILE || homedir();
   if (isWindows(env)) {
-    return join(env.LOCALAPPDATA || join(home, 'AppData', 'Local'), 'throughline', 'completed-turn-receipts', `${projectSha256}.json`);
+    return join(windowsLocalAppData(env), 'throughline', 'completed-turn-receipts', `${projectSha256}.json`);
   }
-  return join(env.XDG_STATE_HOME || join(home, '.local', 'state'), 'throughline', 'completed-turn-receipts', `${projectSha256}.json`);
+  return join(xdgStateHome(env), 'throughline', 'completed-turn-receipts', `${projectSha256}.json`);
 }
 
 /**
@@ -273,7 +273,7 @@ function validateReceipt(receipt, nextSequence) {
   ];
   if (!receipt || typeof receipt !== 'object' || Array.isArray(receipt) ||
     !exactKeys(receipt, keys) || receipt.schema_version !== COMPLETED_TURN_RECEIPT_SCHEMA_VERSION ||
-    receipt.host !== 'claude' || !isSha256(receipt.project_sha256) ||
+    receipt.host !== CLAUDE_HOST || !isSha256(receipt.project_sha256) ||
     !isIdentity(receipt.target_session_id) || !isIdentity(receipt.origin_session_id) ||
     !isSha256(receipt.user_sha256) || !isSha256(receipt.assistant_sha256) ||
     !Number.isSafeInteger(receipt.completed_at) || receipt.completed_at < 0 ||

package/src/hosts/identity.mjs

@@ -1,5 +1,5 @@
 /**
- * hosts/identity.mjs — ベンダー (hook host) 識別の唯一の正本
+ * hosts/identity.mjs — harness (hook host) 識別の唯一の正本
  *
  * Throughline は Claude / Codex / Grok の 3 hook host を同じ SQLite に保存する。
  * host の見分け方は session_id prefix だけであり、その prefix 定義と判定関数を

package/src/os/app-dirs.mjs

@@ -0,0 +1,25 @@
+/**
+ * os/app-dirs.mjs — OS別のユーザー設定/状態ベースディレクトリ解決
+ *
+ * LOCALAPPDATA（Windows）と XDG_CONFIG_HOME / XDG_STATE_HOME（POSIX）の
+ * フォールバック組み立てが runtime-error-store と completed-turn-receipts に
+ * 別々に書かれていたため、ここへ集約する。最終的なアプリ別 join は呼び出し側が持つ。
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+function homeOf(env) {
+  return env.HOME || env.USERPROFILE || homedir();
+}
+
+export function windowsLocalAppData(env = process.env) {
+  return env.LOCALAPPDATA || join(homeOf(env), 'AppData', 'Local');
+}
+
+export function xdgConfigHome(env = process.env) {
+  return env.XDG_CONFIG_HOME || join(homeOf(env), '.config');
+}
+
+export function xdgStateHome(env = process.env) {
+  return env.XDG_STATE_HOME || join(homeOf(env), '.local', 'state');
+}

package/src/os/paths.mjs

@@ -10,3 +10,7 @@ import { platform } from 'node:os';
 export function foldPathCaseForPlatform(path, { hostPlatform = platform() } = {}) {
   return hostPlatform === 'win32' ? path.toLowerCase() : path;
 }
+
+export function isWin32Platform(hostPlatform = platform()) {
+  return hostPlatform === 'win32';
+}

package/src/runtime-error-store.mjs

@@ -10,12 +10,13 @@ import {
   writeFileSync,
 } from 'node:fs';
 import childProcess from 'node:child_process';
-import { arch as hostArch, homedir, platform as hostPlatform } from 'node:os';
+import { arch as hostArch, platform as hostPlatform } from 'node:os';
 import { dirname, join } from 'node:path';
 import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
 import { DatabaseSync } from 'node:sqlite';
 import { applyAndVerifyWindowsAcl, isWindows, verifyWindowsAcl } from './os/windows-acl.mjs';
+import { windowsLocalAppData, xdgConfigHome, xdgStateHome } from './os/app-dirs.mjs';
 
 const require = createRequire(import.meta.url);
 const PACKAGE_VERSION = require('../package.json').version;
@@ -53,19 +54,17 @@ const DEFINITIONS = Object.freeze({
 });
 
 export function defaultFactoryReporterConfigPath(env = process.env) {
-  const home = env.HOME || env.USERPROFILE || homedir();
   if (isWindows(env)) {
-    return join(env.LOCALAPPDATA || join(home, 'AppData', 'Local'), 'dotagents', 'factory-reporter', 'config.json');
+    return join(windowsLocalAppData(env), 'dotagents', 'factory-reporter', 'config.json');
   }
-  return join(env.XDG_CONFIG_HOME || join(home, '.config'), 'dotagents', 'factory-reporter.json');
+  return join(xdgConfigHome(env), 'dotagents', 'factory-reporter.json');
 }
 
 export function defaultRuntimeErrorStorePath(env = process.env) {
-  const home = env.HOME || env.USERPROFILE || homedir();
   if (isWindows(env)) {
-    return join(env.LOCALAPPDATA || join(home, 'AppData', 'Local'), 'throughline', 'runtime-errors.json');
+    return join(windowsLocalAppData(env), 'throughline', 'runtime-errors.json');
   }
-  return join(env.XDG_STATE_HOME || join(home, '.local', 'state'), 'throughline', 'runtime-errors.json');
+  return join(xdgStateHome(env), 'throughline', 'runtime-errors.json');
 }
 
 export function isRuntimeErrorCollectionEnabled({ env = process.env, configPath } = {}) {

package/src/trim-model.mjs

@@ -1,4 +1,5 @@
 import { inspectCodexPlannedRollbackRestoreSafety } from './codex-rollout-memory.mjs';
+import { CLAUDE_HOST, CODEX_HOST } from './hosts/identity.mjs';
 import { buildHandoffRecord, N_RECENT_L2 } from './handoff-record.mjs';
 import { sameProjectPath } from './project-path.mjs';
 import { estimateTokens } from './token-estimator.mjs';
@@ -48,7 +49,7 @@ export function findLatestSessionIdForProject(db, projectPath) {
 
 function resolveDefaultSessionId({ sessionId, host, codexThreadId, db, projectPath }) {
   if (sessionId) return sessionId;
-  if (host === 'codex') {
+  if (host === CODEX_HOST) {
     return codexThreadId ? `codex:${codexThreadId}` : null;
   }
   return findLatestSessionIdForProject(db, projectPath);
@@ -79,7 +80,7 @@ function countDistinctCapturedTurns(db, sessionId) {
 }
 
 export function describeTrimHost(host) {
-  if (host === 'claude') {
+  if (host === CLAUDE_HOST) {
     return {
       host,
       automaticRollback: false,
@@ -94,7 +95,7 @@ export function describeTrimHost(host) {
     };
   }
 
-  if (host === 'codex') {
+  if (host === CODEX_HOST) {
     return {
       host,
       automaticRollback: true,
@@ -123,7 +124,7 @@ export function describeTrimHost(host) {
 }
 
 function buildSafeContinuation({ host, hostIdentity }) {
-  if (host !== 'codex') return null;
+  if (host !== CODEX_HOST) return null;
 
   const threadId = hostIdentity?.codexThreadId ?? '<thread-id>';
   const sessionId = threadId === '<thread-id>' ? 'codex:<thread-id>' : `codex:${threadId}`;
@@ -561,7 +562,7 @@ function buildPlanSession({ resolvedSessionId, session, trimSource, projectPath
 }
 
 function buildHostIdentity({ host, codexThreadId, codexThreadIdSource = null }) {
-  if (host !== 'codex') {
+  if (host !== CODEX_HOST) {
     return {
       host,
       codexThreadId: null,