tailii-host 0.1.0

package/dist/pushTokenCommand.js

@@ -0,0 +1,85 @@
+// pushTokenCommand.ts
+// tailii (TS host) — push-token サブコマンド実装
+// Swift 版 PushTokenCommand.swift の移植。
+//
+// iOS が APNs 登録で得た device token を SSH exec 経由で Mac に受け渡す
+// （`tailii push-token`）。stdin から1行 JSON `{token, environment, bundleId, updatedAt}`
+// を読み、検証（token=hex / environment=production|sandbox / 必須フィールド存在）後に
+// DeviceTokenStore.save で `~/.tailii/apns/device-token.json` に永続化する（3.2/3.3）。
+//
+// 妥当 JSON → exit 0、不正入力 → 非0 exit + stderr メッセージ、書き込みは行わない。
+// token 変化時は上書きで置換される（3.4）。device token は秘匿値として stdout に出さない。
+import { DeviceTokenStore } from "./deviceTokenStore.js";
+import { isApnsHost } from "./pushTypes.js";
+/**
+ * push-token の純ロジック。DeviceTokenStore を注入できるためテスト可能。
+ * stdin バイト列を JSON として解釈し、token(非空 hex) / environment / bundleId / updatedAt を
+ * 検証してから store.save する。いずれか不正なら書き込まず errorSink にメッセージを出して非0。
+ */
+export function pushTokenCore(stdinData, store, errorSink = (m) => process.stderr.write(m)) {
+    // --- JSON を辞書として解釈 ---
+    let obj;
+    try {
+        obj = JSON.parse(stdinData.toString("utf8"));
+    }
+    catch {
+        errorSink("tailii push-token: stdin が有効な JSON オブジェクトではありません\n");
+        return 1;
+    }
+    if (typeof obj !== "object" || obj === null || Array.isArray(obj)) {
+        errorSink("tailii push-token: stdin が有効な JSON オブジェクトではありません\n");
+        return 1;
+    }
+    const dict = obj;
+    // --- token: 非空 hex 文字列 ---
+    const token = dict["token"];
+    if (typeof token !== "string" || token.length === 0) {
+        errorSink("tailii push-token: 'token' が欠落または空です\n");
+        return 1;
+    }
+    if (!/^[0-9a-fA-F]+$/.test(token)) {
+        errorSink("tailii push-token: 'token' は hex 文字列である必要があります\n");
+        return 1;
+    }
+    // --- environment: production | sandbox ---
+    const environment = dict["environment"];
+    if (typeof environment !== "string") {
+        errorSink("tailii push-token: 'environment' が欠落しています\n");
+        return 1;
+    }
+    if (!isApnsHost(environment)) {
+        errorSink("tailii push-token: 'environment' は production|sandbox のいずれかである必要があります\n");
+        return 1;
+    }
+    // --- bundleId: 非空文字列 ---
+    const bundleId = dict["bundleId"];
+    if (typeof bundleId !== "string" || bundleId.length === 0) {
+        errorSink("tailii push-token: 'bundleId' が欠落または空です\n");
+        return 1;
+    }
+    // --- updatedAt: 整数（epoch 秒） ---
+    const updatedAtRaw = dict["updatedAt"];
+    if (typeof updatedAtRaw !== "number" || !Number.isFinite(updatedAtRaw)) {
+        errorSink("tailii push-token: 'updatedAt' が欠落または数値ではありません\n");
+        return 1;
+    }
+    const updatedAt = Math.trunc(updatedAtRaw);
+    // --- 保存（同一パス上書き＝token 置換, 3.4）。token は stdout に出さない（6.5 パリティ） ---
+    try {
+        store.save({ token, environment, bundleId, updatedAt });
+    }
+    catch (error) {
+        errorSink(`tailii push-token: device token の保存に失敗しました: ${String(error)}\n`);
+        return 1;
+    }
+    return 0;
+}
+/** push-token サブコマンドの CLI エントリポイント。stdin を全読みして pushTokenCore へ渡す。 */
+export async function runPushTokenCommand(_args) {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+    }
+    return pushTokenCore(Buffer.concat(chunks), new DeviceTokenStore());
+}
+//# sourceMappingURL=pushTokenCommand.js.map

package/dist/pushTokenCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushTokenCommand.js","sourceRoot":"","sources":["../src/pushTokenCommand.ts"],"names":[],"mappings":"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"}

package/dist/pushTypes.d.ts

@@ -0,0 +1,41 @@
+/**
+ * APNs 送信先の環境。device token の登録環境（DEBUG=sandbox / RELEASE=production）に
+ * 由来し、送信ホストの選択に用いる。JSON 上は `"production"` / `"sandbox"` の文字列。
+ */
+export type ApnsHost = "production" | "sandbox";
+/** 当該環境の APNs ホスト名（token の environment から送信ホストを写像）。 */
+export declare function apnsSendHost(environment: ApnsHost): string;
+/** 文字列が有効な `ApnsHost` か判定する。 */
+export declare function isApnsHost(value: unknown): value is ApnsHost;
+/**
+ * APNs 送信のエラー種別（APNs レスポンスの reason を分類して写像する）。
+ * 呼び出し側はこれをもとに再試行・宛先除外を判断する（Requirement 6.2, 6.3）。
+ */
+export type PushError = {
+    kind: "expiredProviderToken";
+} | {
+    kind: "unregistered";
+} | {
+    kind: "tooManyProviderTokenUpdates";
+} | {
+    kind: "transport";
+    detail: string;
+} | {
+    kind: "http";
+    status: number;
+    reason: string;
+};
+/** 2 つの `PushError` が同値か判定する（テスト・比較用）。 */
+export declare function pushErrorEquals(a: PushError, b: PushError): boolean;
+/** デフォルトの APNs ディレクトリ（`~/.tailii/apns`）。 */
+export declare function defaultApnsBase(): string;
+/** APNs ディレクトリを `0700` で用意する（冪等、非ディレクトリ衝突は例外）。 */
+export declare function ensureApnsDirectory(base: string): void;
+/**
+ * APNs リクエスト本文（最小 aps + カスタムキー）を JSON エンコードして返す。
+ *
+ * payload には承認判断へ導く最小情報（tool 名・セッション・approvalId）のみを含め、
+ * 承認内容の詳細本文・diff・cwd 全文・秘密は載せない（Requirement 2.3 / 6.5）。
+ * キー順の非決定性を避けるため辞書順で符号化する（Swift 版 .sortedKeys と同一）。
+ */
+export declare function pushPayloadBody(approvalId: string, tool: string, session: string): Buffer;

package/dist/pushTypes.js

@@ -0,0 +1,68 @@
+// pushTypes.ts
+// tailii (TS host) — Push レイヤ共通型・保存レイアウト
+// Swift 版 PushPayload.swift（ApnsHost / PushError / PushPayload / ApnsStorage）の移植。
+//
+// 秘密（.p8/token）・diff・cwd 本文を payload/ログに載せない（Requirement 6.5, 2.3）。
+import * as os from "node:os";
+import * as path from "node:path";
+import { ensureDirectory0700 } from "./paths.js";
+/** 当該環境の APNs ホスト名（token の environment から送信ホストを写像）。 */
+export function apnsSendHost(environment) {
+    return environment === "production" ? "api.push.apple.com" : "api.sandbox.push.apple.com";
+}
+/** 文字列が有効な `ApnsHost` か判定する。 */
+export function isApnsHost(value) {
+    return value === "production" || value === "sandbox";
+}
+/** 2 つの `PushError` が同値か判定する（テスト・比較用）。 */
+export function pushErrorEquals(a, b) {
+    if (a.kind !== b.kind)
+        return false;
+    if (a.kind === "transport" && b.kind === "transport")
+        return a.detail === b.detail;
+    if (a.kind === "http" && b.kind === "http")
+        return a.status === b.status && a.reason === b.reason;
+    return true;
+}
+// MARK: - ApnsStorage（保存ディレクトリ規約）
+/** デフォルトの APNs ディレクトリ（`~/.tailii/apns`）。 */
+export function defaultApnsBase() {
+    return path.join(os.homedir(), ".tailii", "apns");
+}
+/** APNs ディレクトリを `0700` で用意する（冪等、非ディレクトリ衝突は例外）。 */
+export function ensureApnsDirectory(base) {
+    ensureDirectory0700(base);
+}
+// MARK: - PushPayload
+/**
+ * APNs リクエスト本文（最小 aps + カスタムキー）を JSON エンコードして返す。
+ *
+ * payload には承認判断へ導く最小情報（tool 名・セッション・approvalId）のみを含め、
+ * 承認内容の詳細本文・diff・cwd 全文・秘密は載せない（Requirement 2.3 / 6.5）。
+ * キー順の非決定性を避けるため辞書順で符号化する（Swift 版 .sortedKeys と同一）。
+ */
+export function pushPayloadBody(approvalId, tool, session) {
+    const alert = { body: `${tool} · ${session}`, title: "承認待ち" };
+    const aps = {
+        alert,
+        "interruption-level": "time-sensitive",
+        sound: "default",
+        "thread-id": session,
+    };
+    const root = { approvalId, aps, session, tool };
+    return Buffer.from(JSON.stringify(sortDeep(root)), "utf8");
+}
+/** ネストした plain object のキーを辞書順に並べ替える（.sortedKeys 相当）。 */
+function sortDeep(value) {
+    if (Array.isArray(value))
+        return value.map(sortDeep);
+    if (value !== null && typeof value === "object") {
+        const obj = value;
+        const sorted = {};
+        for (const key of Object.keys(obj).sort())
+            sorted[key] = sortDeep(obj[key]);
+        return sorted;
+    }
+    return value;
+}
+//# sourceMappingURL=pushTypes.js.map

package/dist/pushTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushTypes.js","sourceRoot":"","sources":["../src/pushTypes.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,yCAAyC;AACzC,kFAAkF;AAClF,EAAE;AACF,oEAAoE;AAEpE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAUjD,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,WAAqB;IAChD,OAAO,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,4BAA4B,CAAC;AAC5F,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,SAAS,CAAC;AACvD,CAAC;AAeD,0CAA0C;AAC1C,MAAM,UAAU,eAAe,CAAC,CAAY,EAAE,CAAY;IACxD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC;IACnF,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC;IAClG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kCAAkC;AAElC,4CAA4C;AAC5C,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,sBAAsB;AAEtB;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,IAAY,EAAE,OAAe;IAC/E,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,MAAM,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC9D,MAAM,GAAG,GAAG;QACV,KAAK;QACL,oBAAoB,EAAE,gBAAgB;QACtC,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,OAAO;KACrB,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAChD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,wDAAwD;AACxD,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/sendLog.d.ts

@@ -0,0 +1,14 @@
+/** セッション別の最終送信時刻を永続する（バースト抑制の最小間隔判定, 7.2）。 */
+export declare class SendLog {
+    private readonly base;
+    constructor(base?: string);
+    private get fileURL();
+    /** 当該セッションの最終送信時刻（Unix 秒）を返す。記録が無ければ `null`。 */
+    lastSent(session: string): number | null;
+    /** 当該セッションの最終送信時刻を更新する（送信成功時に呼ぶ）。 */
+    record(session: string, at: number): void;
+    /** send-log.json を読み込む。欠落・不正 JSON なら空辞書。 */
+    private load;
+    /** send-log.json を 0600 で保存する（ディレクトリは 0700）。保存失敗は握り潰す。 */
+    private save;
+}

package/dist/sendLog.js

@@ -0,0 +1,64 @@
+// sendLog.ts
+// tailii (TS host) — バースト抑制のセッション別レート制限
+// Swift 版 SendLog.swift の移植。
+//
+// `~/.tailii/apns/send-log.json`（`{ "<session>": lastSentEpoch }`）を読み書きする。
+// hook プロセスは短命かつ複数起動しうるため、直近送信時刻はファイルで横断共有する（7.2）。
+// 読み書き失敗は握り潰し、判定は「送信を許可する側（＝抑制しない）」に倒す（best-effort）。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { defaultApnsBase, ensureApnsDirectory } from "./pushTypes.js";
+/** セッション別の最終送信時刻を永続する（バースト抑制の最小間隔判定, 7.2）。 */
+export class SendLog {
+    base;
+    constructor(base) {
+        this.base = base ?? defaultApnsBase();
+    }
+    get fileURL() {
+        return path.join(this.base, "send-log.json");
+    }
+    /** 当該セッションの最終送信時刻（Unix 秒）を返す。記録が無ければ `null`。 */
+    lastSent(session) {
+        const value = this.load()[session];
+        return typeof value === "number" ? value : null;
+    }
+    /** 当該セッションの最終送信時刻を更新する（送信成功時に呼ぶ）。 */
+    record(session, at) {
+        const map = this.load();
+        map[session] = at;
+        this.save(map);
+    }
+    /** send-log.json を読み込む。欠落・不正 JSON なら空辞書。 */
+    load() {
+        let raw;
+        try {
+            raw = JSON.parse(fs.readFileSync(this.fileURL, "utf8"));
+        }
+        catch {
+            return {};
+        }
+        if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+            return {};
+        const result = {};
+        for (const [key, value] of Object.entries(raw)) {
+            if (typeof value === "number")
+                result[key] = value;
+        }
+        return result;
+    }
+    /** send-log.json を 0600 で保存する（ディレクトリは 0700）。保存失敗は握り潰す。 */
+    save(map) {
+        try {
+            ensureApnsDirectory(this.base);
+            const sorted = {};
+            for (const key of Object.keys(map).sort())
+                sorted[key] = map[key];
+            fs.writeFileSync(this.fileURL, JSON.stringify(sorted), { mode: 0o600 });
+            fs.chmodSync(this.fileURL, 0o600);
+        }
+        catch {
+            // 保存失敗は致命ではない（次回も送信できる）。
+        }
+    }
+}
+//# sourceMappingURL=sendLog.js.map

package/dist/sendLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendLog.js","sourceRoot":"","sources":["../src/sendLog.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,wCAAwC;AACxC,6BAA6B;AAC7B,EAAE;AACF,2EAA2E;AAC3E,mDAAmD;AACnD,qDAAqD;AAErD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,8CAA8C;AAC9C,MAAM,OAAO,OAAO;IACD,IAAI,CAAS;IAE9B,YAAY,IAAa;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,gDAAgD;IAChD,QAAQ,CAAC,OAAe;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,OAAe,EAAE,EAAU;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,4CAA4C;IACpC,IAAI;QACV,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAC7E,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,0DAA0D;IAClD,IAAI,CAAC,GAA2B;QACtC,IAAI,CAAC;YACH,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAE,CAAC;YACnE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;CACF"}

package/dist/sessionActivityProvider.d.ts

@@ -0,0 +1,7 @@
+import type { SessionInfo } from "./protocol.js";
+/** セッションの更新時刻（Unix 秒）を解決する注入可能な抽象。解決不能は null。 */
+export type SessionActivityProvider = (session: SessionInfo) => number | null;
+/** cwd を Claude Code projects の slug へ写す（`/` と `.` を `-` に置換）。 */
+export declare function activitySlugForCwd(cwd: string): string;
+/** Claude Code トランスクリプトの最新 mtime を updatedAt として返す既定実装。 */
+export declare function claudeTranscriptActivityProvider(projectsBase?: string): SessionActivityProvider;

package/dist/sessionActivityProvider.js

@@ -0,0 +1,44 @@
+// sessionActivityProvider.ts
+// tailii (TS host) — セッション更新時刻の権威解決（session-list-lifecycle 1.3/1.4）
+// Swift 版 SessionActivityProvider.swift の移植。
+// updatedAt は Claude Code トランスクリプト（`~/.claude/projects/<slug>/*.jsonl`）の最大 mtime。
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { standardize } from "./paths.js";
+/** cwd を Claude Code projects の slug へ写す（`/` と `.` を `-` に置換）。 */
+export function activitySlugForCwd(cwd) {
+    return standardize(cwd).replaceAll("/", "-").replaceAll(".", "-");
+}
+/** Claude Code トランスクリプトの最新 mtime を updatedAt として返す既定実装。 */
+export function claudeTranscriptActivityProvider(projectsBase) {
+    const base = projectsBase ?? path.join(os.homedir(), ".claude", "projects");
+    return (session) => {
+        const cwd = session.cwd;
+        if (!cwd)
+            return null;
+        const dir = path.join(base, activitySlugForCwd(cwd));
+        let entries;
+        try {
+            entries = fs.readdirSync(dir);
+        }
+        catch {
+            return null;
+        }
+        let latest = null;
+        for (const entry of entries) {
+            if (!entry.endsWith(".jsonl") || entry.startsWith("."))
+                continue;
+            try {
+                const secs = Math.floor(fs.statSync(path.join(dir, entry)).mtimeMs / 1000);
+                if (latest === null || secs > latest)
+                    latest = secs;
+            }
+            catch {
+                // 個別ファイルの stat 失敗はスキップ。
+            }
+        }
+        return latest;
+    };
+}
+//# sourceMappingURL=sessionActivityProvider.js.map

package/dist/sessionActivityProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionActivityProvider.js","sourceRoot":"","sources":["../src/sessionActivityProvider.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,oEAAoE;AACpE,6CAA6C;AAC7C,kFAAkF;AAElF,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAKzC,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gCAAgC,CAAC,YAAqB;IACpE,MAAM,IAAI,GAAG,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC5E,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,MAAM,GAAkB,IAAI,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACjE,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;gBAC3E,IAAI,MAAM,KAAK,IAAI,IAAI,IAAI,GAAG,MAAM;oBAAE,MAAM,GAAG,IAAI,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/sessionIdleTracker.d.ts

@@ -0,0 +1,19 @@
+/** セッションのアイドル起点を記録し、timeout 超過集合を返すトラッカー。 */
+export declare class SessionIdleTracker {
+    private readonly timeout;
+    /** name → アイドル起点（Unix 秒）。未設定＝アクティブ/対象外。 */
+    private idleSince;
+    constructor(timeout: number);
+    /** 設定中の timeout（秒）。 */
+    get timeoutSeconds(): number;
+    /** アイドル起点を設定する（chat 離脱, 要件 4.2）。 */
+    markIdle(name: string, at: number): void;
+    /** アイドル起点を解除してアクティブ化する（reattach, 要件 4.4）。 */
+    markActive(name: string): void;
+    /** kill 後にエントリを掃除する（二重 kill 回避）。 */
+    remove(name: string): void;
+    /** `now - idleSince >= timeout` を満たす name 集合（name 昇順、未設定は除外, 4.3/4.5）。 */
+    expired(now: number): string[];
+    /** 現在アイドル起点が設定されている name 集合（テスト/検証補助）。 */
+    idleNames(): string[];
+}

package/dist/sessionIdleTracker.js

@@ -0,0 +1,42 @@
+// sessionIdleTracker.ts
+// tailii (TS host) — tmux アイドル起点の計時（session-list-lifecycle 4.x）
+// Swift 版 SessionIdleTracker.swift の移植（Node は単一スレッドのため actor は不要）。
+/** セッションのアイドル起点を記録し、timeout 超過集合を返すトラッカー。 */
+export class SessionIdleTracker {
+    timeout;
+    /** name → アイドル起点（Unix 秒）。未設定＝アクティブ/対象外。 */
+    idleSince = new Map();
+    constructor(timeout) {
+        this.timeout = timeout;
+    }
+    /** 設定中の timeout（秒）。 */
+    get timeoutSeconds() {
+        return this.timeout;
+    }
+    /** アイドル起点を設定する（chat 離脱, 要件 4.2）。 */
+    markIdle(name, at) {
+        this.idleSince.set(name, at);
+    }
+    /** アイドル起点を解除してアクティブ化する（reattach, 要件 4.4）。 */
+    markActive(name) {
+        this.idleSince.delete(name);
+    }
+    /** kill 後にエントリを掃除する（二重 kill 回避）。 */
+    remove(name) {
+        this.idleSince.delete(name);
+    }
+    /** `now - idleSince >= timeout` を満たす name 集合（name 昇順、未設定は除外, 4.3/4.5）。 */
+    expired(now) {
+        const result = [];
+        for (const [name, since] of this.idleSince) {
+            if (now - since >= this.timeout)
+                result.push(name);
+        }
+        return result.sort();
+    }
+    /** 現在アイドル起点が設定されている name 集合（テスト/検証補助）。 */
+    idleNames() {
+        return [...this.idleSince.keys()].sort();
+    }
+}
+//# sourceMappingURL=sessionIdleTracker.js.map

package/dist/sessionIdleTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionIdleTracker.js","sourceRoot":"","sources":["../src/sessionIdleTracker.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,gEAAgE;AAChE,mEAAmE;AAEnE,6CAA6C;AAC7C,MAAM,OAAO,kBAAkB;IAIA;IAH7B,2CAA2C;IACnC,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEhD,uBAAuB;IACvB,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,oCAAoC;IACpC,QAAQ,CAAC,IAAY,EAAE,EAAU;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,6CAA6C;IAC7C,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAC1E,OAAO,CAAC,GAAW;QACjB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3C,IAAI,GAAG,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,0CAA0C;IAC1C,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF"}

package/dist/sessionListService.d.ts

@@ -0,0 +1,27 @@
+import type { SessionInfo } from "./protocol.js";
+import type { SessionActivityProvider } from "./sessionActivityProvider.js";
+import type { TmuxSessionManager } from "./tmux.js";
+/** 1 ページ分の整列済みセッションと続き位置。 */
+export interface SessionListPage {
+    sessions: SessionInfo[];
+    nextCursor: string | null;
+}
+/** limit 省略時の既定 1 ページ件数（要件 2.9）。 */
+export declare const SESSION_LIST_DEFAULT_LIMIT = 5;
+interface CursorKey {
+    u: number;
+    n: string;
+}
+/** `(updatedAt, name)` を base64url(JSON) の不透明トークンへ符号化する。 */
+export declare function encodeSessionListCursor(updatedAt: number, name: string): string;
+/** 不透明トークンを整列キーへ復号する。復号不能は null（呼び出し側は先頭ページ扱い）。 */
+export declare function decodeSessionListCursor(token: string): CursorKey | null;
+/** list を更新時間降順/名前昇順に整列し keyset ページングする純サービス。 */
+export declare class SessionListService {
+    private readonly sessionManager;
+    private readonly activityProvider;
+    constructor(sessionManager: TmuxSessionManager, activityProvider: SessionActivityProvider);
+    /** 更新時間降順/名前昇順で整列し、cursor より後方を limit 件返す。 */
+    page(limit: number | undefined, cursor: string | undefined): Promise<SessionListPage>;
+}
+export {};

package/dist/sessionListService.js

@@ -0,0 +1,85 @@
+// sessionListService.ts
+// tailii (TS host) — セッション一覧の整列 + keyset ページング（session-list-lifecycle 1.x/2.x）
+// Swift 版 SessionListService.swift の移植。
+// (updatedAt desc, name asc) の安定順に整列し、不透明カーソルより後方を 1 ページ切り出す。
+/** limit 省略時の既定 1 ページ件数（要件 2.9）。 */
+export const SESSION_LIST_DEFAULT_LIMIT = 5;
+/** `(updatedAt, name)` を base64url(JSON) の不透明トークンへ符号化する。 */
+export function encodeSessionListCursor(updatedAt, name) {
+    // Swift 版 .sortedKeys と同じ `{"n":…,"u":…}` の正準形。
+    const json = JSON.stringify({ n: name, u: updatedAt });
+    return Buffer.from(json, "utf8").toString("base64url");
+}
+/** 不透明トークンを整列キーへ復号する。復号不能は null（呼び出し側は先頭ページ扱い）。 */
+export function decodeSessionListCursor(token) {
+    try {
+        const raw = JSON.parse(Buffer.from(token, "base64url").toString("utf8"));
+        if (typeof raw !== "object" || raw === null)
+            return null;
+        const obj = raw;
+        if (typeof obj["u"] !== "number" || typeof obj["n"] !== "string")
+            return null;
+        return { u: obj["u"], n: obj["n"] };
+    }
+    catch {
+        return null;
+    }
+}
+/** list を更新時間降順/名前昇順に整列し keyset ページングする純サービス。 */
+export class SessionListService {
+    sessionManager;
+    activityProvider;
+    constructor(sessionManager, activityProvider) {
+        this.sessionManager = sessionManager;
+        this.activityProvider = activityProvider;
+    }
+    /** 更新時間降順/名前昇順で整列し、cursor より後方を limit 件返す。 */
+    async page(limit, cursor) {
+        const raw = await this.sessionManager.list();
+        // updatedAt を付与する（未解決は省略 = 比較上 0）。
+        // tmux 由来の per-session 活動時刻（sessionManager.list() が付与）を最優先し、
+        // 無い場合のみ従来の provider（claude transcript mtime）へフォールバックする。
+        // これにより同一 cwd の複数セッションでも共有トランスクリプト mtime に潰されず、
+        // セッション個別の最近使用順で正しく整列する（最新セッションが一覧に埋もれない）。
+        const annotated = raw.map((info) => {
+            if (info.updatedAt !== undefined)
+                return info;
+            const updatedAt = this.activityProvider(info);
+            return updatedAt === null ? { ...info } : { ...info, updatedAt };
+        });
+        // (updatedAt desc, name asc) の安定ソート。
+        const sorted = annotated.slice().sort((lhs, rhs) => {
+            const lu = lhs.updatedAt ?? 0;
+            const ru = rhs.updatedAt ?? 0;
+            if (lu !== ru)
+                return ru - lu;
+            return lhs.name < rhs.name ? -1 : lhs.name > rhs.name ? 1 : 0;
+        });
+        // keyset seek: cursor（末尾キー）より「後方」の先頭位置を求める。
+        let startIndex = 0;
+        if (cursor !== undefined) {
+            const key = decodeSessionListCursor(cursor);
+            if (key !== null) {
+                const idx = sorted.findIndex((info) => isAfter(info, key));
+                startIndex = idx === -1 ? sorted.length : idx;
+            }
+        }
+        const effectiveLimit = Math.max(0, limit ?? SESSION_LIST_DEFAULT_LIMIT);
+        const endIndex = Math.min(startIndex + effectiveLimit, sorted.length);
+        const pageSessions = sorted.slice(startIndex, endIndex);
+        const hasMore = endIndex < sorted.length;
+        const last = pageSessions[pageSessions.length - 1];
+        const nextCursor = hasMore && last !== undefined
+            ? encodeSessionListCursor(last.updatedAt ?? 0, last.name)
+            : null;
+        return { sessions: pageSessions, nextCursor };
+    }
+}
+/** 降順 seek における「後方」判定: `u < u0` または（`u == u0` かつ `n > n0`）。 */
+function isAfter(info, key) {
+    const u = info.updatedAt ?? 0;
+    if (u !== key.u)
+        return u < key.u;
+    return info.name > key.n;
+}
+//# sourceMappingURL=sessionListService.js.map

package/dist/sessionListService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionListService.js","sourceRoot":"","sources":["../src/sessionListService.ts"],"names":[],"mappings":"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"}

package/dist/sessionMetadataStore.d.ts

@@ -0,0 +1,33 @@
+/** 1 セッション分のメタデータ（createdAt は Unix 秒）。 */
+export interface SessionMeta {
+    name: string;
+    cwd: string;
+    createdAt: number;
+    /** そのセッションを駆動するエージェント（claude=既定 / codex）。未記録は claude 相当。 */
+    agent?: "claude" | "codex";
+    /** Claude の会話 JSONL 名に対応する session-id。未記録は従来どおり最新 JSONL 解決へ戻す。 */
+    claudeSessionId?: string;
+}
+/** session 名が安全でないときに投げる型付きエラー。 */
+export declare class InvalidSessionNameError extends Error {
+    constructor(name: string);
+}
+/** session 名の安全性を検証する（空 / null バイト / `/` / `.`・`..` を拒否）。 */
+export declare function validateSessionName(name: string): void;
+/** デフォルトのベースディレクトリ（`~/.tailii/sessions`）。 */
+export declare function defaultSessionsBase(): string;
+/**
+ * セッションメタデータの永続ストア（cwd 権威記録）。
+ * 1 ファイル 1 セッション（`<base>/<name>.json`）。テストは一時 dir を注入する。
+ */
+export declare class SessionMetadataStore {
+    private readonly base;
+    constructor(base?: string);
+    /** セッションメタデータを保存する（同一 name は上書き）。 */
+    put(meta: SessionMeta): void;
+    /** 指定 name のメタデータ。存在しない / 読めない場合は null（throw しない設計）。 */
+    get(name: string): SessionMeta | null;
+    /** 保存済みの全メタデータ（壊れたファイルは無視、順序不定）。 */
+    all(): SessionMeta[];
+    private fileFor;
+}