tailii-host 0.1.0 → 0.3.0

package/dist/services/quicGateway.js

@@ -0,0 +1,292 @@
+// quicGateway.ts — QUIC ゲートウェイ（tailii-quic-gw）の解決・資格情報・launchd 常駐
+//
+// 設計正本: docs/quic-transport.md（モノレポルート）。
+// ゲートウェイ本体は Rust バイナリ（quic-gw/）。この module は host-ts 側の運用面
+// （バイナリ解決 / 資格情報の生成読込 / launchd LaunchAgent の設置）だけを担う。
+//
+// - 資格情報（P-256 証明書 + 32byte トークン）の生成は Rust 側
+//   `tailii-quic-gw credentials --json` に委譲する（Node に X.509 生成が無いため）。
+// - ゲートウェイは launchd 常駐（KeepAlive）。SSH と違い、接続前に誰かが起こして
+//   おく必要があるため（Mac 再起動後の初回接続で誰も居ない問題の回避）。
+import { execFile } from "node:child_process";
+import { createHash, X509Certificate } from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import { findCommand } from "../commands/doctor.js";
+import { defaultInjectedPath } from "../commands/launch.js";
+/** launchd ジョブのラベル（plist ファイル名と対）。 */
+export const QUIC_GW_LAUNCHD_LABEL = "com.tailii.quic-gw";
+/** ゲートウェイの既定 UDP ポート（凍結定数、Rust 側 DEFAULT_PORT と一致）。 */
+export const QUIC_GW_DEFAULT_PORT = 46853;
+/** 資格情報ディレクトリ（Rust 側 default_credentials_dir と対）。 */
+export function quicCredentialsDir() {
+    return path.join(os.homedir(), ".tailii", "quic");
+}
+/** ゲートウェイの監査ログパス（launchd が stdout/stderr をここへ向ける）。 */
+export function quicGatewayLogPath() {
+    return path.join(os.homedir(), ".tailii", "quic-gw.log");
+}
+/**
+ * launchd が起動する gateway バイナリの設置先（`~/.tailii/bin/tailii-quic-gw`）。
+ *
+ * 重要（実機で判明した罠）: launchd の LaunchAgent は `~/Documents` `~/Desktop`
+ * `~/Downloads` 等の **TCC 保護フォルダにアクセスできない**。ビルド成果物や npm 配布物が
+ * そうした場所にあると、launchd 起動時に dyld がバイナリを map できず **dyld 段階で無限
+ * ストール**する（プロセスは生存するが bind に到達せず、ログも出ない）。Terminal 起動は
+ * ユーザーの TCC 付与を継承するため成功し、差分に気付きにくい。回避のため、常駐用バイナリは
+ * 必ず非 TCC 保護の隠しディレクトリ `~/.tailii/bin` へコピーしてから launchd に渡す。
+ */
+export function quicGatewayInstalledBinaryPath() {
+    return path.join(os.homedir(), ".tailii", "bin", "tailii-quic-gw");
+}
+/**
+ * gateway バイナリを非 TCC 保護の `~/.tailii/bin` へコピーして、その設置先パスを返す。
+ * 内容が同一なら再コピーしない（mtime/サイズで判定）。常に実行ビットを立てる。
+ */
+export function installQuicGatewayBinary(sourcePath) {
+    const dest = quicGatewayInstalledBinaryPath();
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    const sourceStat = fs.statSync(sourcePath);
+    let needCopy = true;
+    try {
+        const destStat = fs.statSync(dest);
+        // サイズ一致 かつ コピー先が新しければ据え置き（cargo 再ビルドは mtime が進む）。
+        needCopy = !(destStat.size === sourceStat.size && destStat.mtimeMs >= sourceStat.mtimeMs);
+    }
+    catch {
+        needCopy = true;
+    }
+    if (needCopy) {
+        fs.copyFileSync(sourcePath, dest);
+    }
+    fs.chmodSync(dest, 0o755);
+    return dest;
+}
+/** LaunchAgent plist の設置先。 */
+export function quicLaunchAgentPlistPath() {
+    return path.join(os.homedir(), "Library", "LaunchAgents", `${QUIC_GW_LAUNCHD_LABEL}.plist`);
+}
+// MARK: - バイナリ解決
+/**
+ * ゲートウェイバイナリを解決する。見つからなければ null（QUIC は任意機能なので
+ * 呼び出し側は SSH-only で継続してよい）。
+ *
+ * 解決順:
+ *   1. 環境変数 `TAILII_QUIC_GW`（明示上書き）
+ *   2. npm prebuilt（optionalDependencies `@tailii/quic-gw-darwin-{arm64,x64}`）
+ *   3. モノレポのローカル cargo ビルド（quic-gw/target/release/tailii-quic-gw）
+ *   4. PATH
+ */
+export function resolveQuicGatewayBinary(env = process.env) {
+    const explicit = env["TAILII_QUIC_GW"];
+    if (explicit !== undefined && explicit !== "" && fs.existsSync(explicit))
+        return explicit;
+    // 2) prebuilt npm package（配布時。未導入環境では解決失敗して次へ）。
+    const arch = os.arch() === "arm64" ? "arm64" : "x64";
+    try {
+        const require = createRequire(import.meta.url);
+        const pkgDir = path.dirname(require.resolve(`@tailii/quic-gw-darwin-${arch}/package.json`));
+        const candidate = path.join(pkgDir, "bin", "tailii-quic-gw");
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    catch {
+        // 未導入。次の解決先へ。
+    }
+    // 3) ローカル cargo ビルド（開発機）。dist/services/quicGateway.js → パッケージルート → quic-gw/。
+    const pkgRoot = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+    for (const profile of ["release", "debug"]) {
+        const candidate = path.join(pkgRoot, "quic-gw", "target", profile, "tailii-quic-gw");
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    // 4) PATH。
+    return findCommand("tailii-quic-gw", env["PATH"] ?? "");
+}
+const defaultRunner = (file, args) => new Promise((resolve, reject) => {
+    execFile(file, args, { timeout: 15_000 }, (error, stdout) => {
+        if (error)
+            reject(error);
+        else
+            resolve(stdout);
+    });
+});
+/**
+ * 資格情報を生成（既存なら読込・冪等）して返す。
+ * 実体は `tailii-quic-gw credentials --json --dir <dir>`。
+ */
+export async function ensureQuicCredentials(gatewayPath, dir = quicCredentialsDir(), runner = defaultRunner) {
+    const stdout = await runner(gatewayPath, ["credentials", "--json", "--dir", dir]);
+    const parsed = JSON.parse(stdout.trim());
+    if (typeof parsed !== "object" || parsed === null ||
+        typeof parsed.spkiPin !== "string" ||
+        typeof parsed.token !== "string" ||
+        typeof parsed.port !== "number") {
+        throw new Error(`tailii-quic-gw credentials --json の出力が不正です: ${stdout.trim()}`);
+    }
+    return parsed;
+}
+// MARK: - launchd LaunchAgent
+/** XML テキストノードのエスケープ（plist 値に埋める文字列用）。 */
+function xmlEscape(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;");
+}
+/**
+ * LaunchAgent plist の内容（KeepAlive 常駐・監査ログは stdout/stderr リダイレクト）。
+ *
+ * 重要（実機で判明した罠）: macOS の GUI LaunchAgent は **HOME を継承しない**。
+ * ゲートウェイは `~/.tailii/quic` の展開・`default_injected_path` の両方で HOME を読むため、
+ * HOME 空だと資格情報ディレクトリが `/.tailii/quic` に化けて `create_dir_all` が失敗し、
+ * serve が即終了 → KeepAlive 再起動ループに陥る。対策として:
+ *   1. `EnvironmentVariables` に HOME を明示（gateway 本体 + exec 子プロセス双方に効く）。
+ *   2. `--dir` / `--path` を **絶対パスで明示的に渡し**、HOME 展開へ依存しない（防御多重化）。
+ */
+export function quicLaunchAgentPlist(config) {
+    const args = [
+        config.gatewayPath,
+        "serve",
+        "--dir",
+        config.credentialsDir,
+        "--path",
+        config.injectedPath,
+    ];
+    const programArguments = args.map((arg) => `    <string>${xmlEscape(arg)}</string>`).join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${QUIC_GW_LAUNCHD_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${programArguments}
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>HOME</key>
+    <string>${xmlEscape(config.home)}</string>
+    <key>PATH</key>
+    <string>${xmlEscape(config.injectedPath)}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${xmlEscape(config.logPath)}</string>
+  <key>StandardErrorPath</key>
+  <string>${xmlEscape(config.logPath)}</string>
+</dict>
+</plist>
+`;
+}
+const defaultLaunchctl = (args) => new Promise((resolve, reject) => {
+    execFile("launchctl", args, { timeout: 15_000 }, (error) => {
+        if (error)
+            reject(error);
+        else
+            resolve();
+    });
+});
+/**
+ * LaunchAgent を設置して（再）起動する（冪等）。
+ * 既存ジョブは bootout してから bootstrap し、plist 更新を確実に反映する。
+ *
+ * gateway バイナリは非 TCC 保護の `~/.tailii/bin` へコピーしてから launchd に渡す
+ * （`installQuicGatewayBinary` 参照。TCC 保護フォルダ由来の dyld ストール回避）。
+ */
+export async function installQuicLaunchAgent(options) {
+    const plistPath = options.plistPath ?? quicLaunchAgentPlistPath();
+    const logPath = options.logPath ?? quicGatewayLogPath();
+    const uid = options.uid ?? process.getuid?.() ?? 501;
+    const launchctl = options.launchctl ?? defaultLaunchctl;
+    const installBinary = options.installBinary ?? installQuicGatewayBinary;
+    // TCC 保護フォルダ（~/Documents 等）から launchd 起動すると dyld がストールするため、
+    // 常駐用バイナリは非保護の隠しディレクトリへコピーしてそこを起動する。
+    const launchBinary = installBinary(options.gatewayPath);
+    fs.mkdirSync(path.dirname(plistPath), { recursive: true });
+    fs.writeFileSync(plistPath, quicLaunchAgentPlist({
+        gatewayPath: launchBinary,
+        logPath,
+        credentialsDir: options.credentialsDir ?? quicCredentialsDir(),
+        injectedPath: options.injectedPath ?? defaultInjectedPath(),
+        home: options.home ?? os.homedir(),
+    }), { mode: 0o644 });
+    // 既存ジョブは落としてから載せ直す（未登録の bootout 失敗は無視）。
+    try {
+        await launchctl(["bootout", `gui/${uid}/${QUIC_GW_LAUNCHD_LABEL}`]);
+    }
+    catch {
+        // 未登録なら失敗するのが正常。
+    }
+    try {
+        await launchctl(["bootstrap", `gui/${uid}`, plistPath]);
+    }
+    catch {
+        // 旧 macOS / 非 GUI セッション向けフォールバック。
+        await launchctl(["load", "-w", plistPath]);
+    }
+}
+/** launchd ジョブが常駐しているか（doctor / quic-info 用・副作用なし）。 */
+export async function isQuicGatewayLoaded(uid = process.getuid?.() ?? 501, launchctl = defaultLaunchctl) {
+    try {
+        await launchctl(["print", `gui/${uid}/${QUIC_GW_LAUNCHD_LABEL}`]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 証明書 PEM から SPKI SHA-256 ピン（base64）を計算する。
+ * Rust 側 `Credentials::spki_pin()`（rcgen public_key_der のハッシュ）と同一値になる
+ * （X.509 の SubjectPublicKeyInfo DER は同一バイト列のため）。
+ */
+export function computeSpkiPinFromCertPem(certPem) {
+    const cert = new X509Certificate(certPem);
+    const spkiDer = cert.publicKey.export({ type: "spki", format: "der" });
+    return createHash("sha256").update(spkiDer).digest("base64");
+}
+/**
+ * ディスク上の資格情報（cert.pem / token）から quic-info の中身を読む。
+ * ゲートウェイバイナリには依存しない（生成は setup / Rust 側の責務。ここは読むだけ）。
+ */
+export function readQuicCredentialsFromDisk(dir = quicCredentialsDir()) {
+    try {
+        const certPem = fs.readFileSync(path.join(dir, "cert.pem"), "utf8");
+        const token = fs.readFileSync(path.join(dir, "token"), "utf8").trim();
+        if (token === "")
+            return null;
+        return { pin: computeSpkiPinFromCertPem(certPem), token };
+    }
+    catch {
+        return null;
+    }
+}
+/** quic-info の本体（テスト注入可能な純ロジック）。 */
+export async function collectQuicInfo(options) {
+    const creds = readQuicCredentialsFromDisk(options?.dir ?? quicCredentialsDir());
+    if (creds === null) {
+        return { available: false, reason: "credentials-missing" };
+    }
+    const loaded = await (options?.isLoaded ?? (() => isQuicGatewayLoaded()))();
+    if (!loaded) {
+        // 常駐していないのに資格情報だけ配ると、クライアントが再接続のたびに
+        // 死んだゲートウェイへ 1.5s の接続試行税を払う。配らない方が安全側。
+        return { available: false, reason: "gateway-not-running" };
+    }
+    return { available: true, port: QUIC_GW_DEFAULT_PORT, pin: creds.pin, token: creds.token };
+}
+/** `tailii-host quic-info` エントリポイント。stdout に JSON 1 行を出す（常に exit 0）。 */
+export async function runQuicInfoCommand(_argv) {
+    const info = await collectQuicInfo();
+    process.stdout.write(JSON.stringify(info) + "\n");
+    return 0;
+}
+//# sourceMappingURL=quicGateway.js.map

package/dist/services/quicGateway.js.map

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

package/dist/services/serveService.d.ts

@@ -0,0 +1,50 @@
+import type { ServeProcessInfo } from "../protocol.js";
+/** `*:5173` / `127.0.0.1:5173` / `[::1]:5173` からポート番号を取り出す。 */
+export declare function parseListenPort(name: string): number | null;
+/**
+ * `lsof -Fpcn` の機械可読出力を (pid, port) の組へパースする。
+ * 出力はプロセスブロック（p/c 行）に n 行（bind 先）が続く形。
+ */
+export declare function parseLsofListenOutput(output: string): {
+    pid: number;
+    command: string;
+    port: number;
+}[];
+/** `lsof -a -d cwd -Fpn -p <pids>` の出力を pid → cwd へパースする。 */
+export declare function parseLsofCwdOutput(output: string): Map<number, string>;
+/**
+ * HTML 断片から `<title>` の中身を取り出す。空・見つからない場合は null。
+ * 表示用に空白を畳み、基本的な文字参照を復号して TITLE_LIMIT で切り詰める。
+ */
+export declare function parseHtmlTitle(html: string): string | null;
+/**
+ * 自ユーザーが loopback/wildcard で LISTEN している TCP サーバーを列挙する。
+ * `excludePids` は engine 自身など一覧に出さない pid。
+ * `withTitles` で各ポートへ HTTP GET し HTML の `<title>` を付与する
+ * （一覧表示用。停止前照合など内部利用では省く）。
+ */
+export interface ServeProcessListResult {
+    /** false は lsof 未導入・timeout 等で一覧の完全性を保証できないことを表す。 */
+    ok: boolean;
+    servers: ServeProcessInfo[];
+}
+/**
+ * 一覧と検出成否を返す。reaper は `ok=false` を「サーバーなし」とみなさず回収を延期する。
+ */
+export declare function listServeProcessesWithStatus(options?: {
+    excludePids?: number[];
+    withTitles?: boolean;
+}): Promise<ServeProcessListResult>;
+/** 従来の一覧 API。UI/停止処理は失敗時も取得できた部分結果を表示する。 */
+export declare function listServeProcesses(options?: {
+    excludePids?: number[];
+    withTitles?: boolean;
+}): Promise<ServeProcessInfo[]>;
+/**
+ * pid のサーバーを停止する。pid 再利用の誤爆を防ぐため、その pid が今も
+ * 指定 port で LISTEN していることを確認してから SIGTERM → SIGKILL する。
+ */
+export declare function stopServeProcess(pid: number, port: number): Promise<{
+    ok: boolean;
+    error: string | null;
+}>;

package/dist/services/serveService.js

@@ -0,0 +1,302 @@
+// serveService.ts
+// tailii (TS host) — Mac 上で LISTEN 中の開発サーバー一覧と停止（serve-list）
+//
+// iOS の「Webサーバー」一覧は、この Mac で自ユーザーが LISTEN している TCP ポートを
+// lsof で列挙して表示する。dev サーバー（vite / next / python -m http.server 等）は
+// プロジェクト dir を cwd に持つため、cwd を返して iOS 側で会話 workdir との
+// グルーピングに使う。ノイズ削減のため以下は host 側で除外する:
+//   - engine 自身（previewServer の loopback 静的サーバーを含む）
+//   - cwd が "/" のプロセス（launchd 起動の常駐アプリ・デーモン類。dev サーバーは
+//     必ず実プロジェクトの cwd を持つ）
+//   - loopback/wildcard 以外へ bind しているソケット（LAN 固定 bind は対象外）
+//
+// 停止は pid 再利用による誤 kill を防ぐため「その pid が今もそのポートで LISTEN
+// している」ことを確認してから SIGTERM → 猶予後 SIGKILL の順で行う。
+import { execFile } from "node:child_process";
+const LSOF_TIMEOUT_MS = 8_000;
+const EXEC_MAX_BUFFER = 4 * 1024 * 1024;
+/** SIGTERM 後にプロセス終了を待つ最大時間。 */
+const TERM_GRACE_MS = 1_500;
+/** SIGKILL 後にプロセス終了を待つ最大時間。 */
+const KILL_GRACE_MS = 700;
+const POLL_INTERVAL_MS = 100;
+const COMMAND_LINE_LIMIT = 160;
+/** title 取得の HTTP GET 全体タイムアウト。非 HTTP リスナーはここで切れる。 */
+const TITLE_FETCH_TIMEOUT_MS = 1_200;
+/** title 探索で読む HTML 先頭バイト数の上限。 */
+const TITLE_BODY_LIMIT = 64 * 1024;
+const TITLE_LIMIT = 80;
+function run(command, args) {
+    return new Promise((resolve) => {
+        execFile(command, args, { timeout: LSOF_TIMEOUT_MS, maxBuffer: EXEC_MAX_BUFFER, encoding: "utf8" }, (error, stdout, stderr) => {
+            const typed = error;
+            // lsof は「該当なし」でも stderr なしの exit 1 を返す。これは信頼できる空結果。
+            // ENOENT・timeout・signal 終了は部分 stdout があっても不完全なので失敗扱いにする。
+            const noMatches = typed !== null && typed.code === 1 && String(stdout).length === 0 &&
+                String(stderr).length === 0 && typed.killed !== true && typed.signal == null;
+            resolve({
+                ok: error === null || noMatches,
+                stdout: String(stdout),
+            });
+        });
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** `*:5173` / `127.0.0.1:5173` / `[::1]:5173` からポート番号を取り出す。 */
+export function parseListenPort(name) {
+    const colon = name.lastIndexOf(":");
+    if (colon < 0)
+        return null;
+    const port = Number(name.slice(colon + 1));
+    if (!Number.isInteger(port) || port <= 0 || port > 65535)
+        return null;
+    const host = name.slice(0, colon);
+    // loopback / wildcard のみ対象（明示的な LAN bind は開発サーバー一覧の対象外）。
+    const allowed = new Set(["*", "127.0.0.1", "localhost", "[::1]", "[::]", "0.0.0.0"]);
+    return allowed.has(host) ? port : null;
+}
+/**
+ * `lsof -Fpcn` の機械可読出力を (pid, port) の組へパースする。
+ * 出力はプロセスブロック（p/c 行）に n 行（bind 先）が続く形。
+ */
+export function parseLsofListenOutput(output) {
+    const results = [];
+    const seen = new Set();
+    let pid = null;
+    let command = "";
+    for (const line of output.split("\n")) {
+        if (line.startsWith("p")) {
+            pid = Number(line.slice(1));
+            command = "";
+            continue;
+        }
+        if (line.startsWith("c")) {
+            command = line.slice(1);
+            continue;
+        }
+        if (line.startsWith("n") && pid !== null) {
+            const port = parseListenPort(line.slice(1));
+            if (port === null)
+                continue;
+            const key = `${pid}:${port}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            results.push({ pid, command, port });
+        }
+    }
+    return results;
+}
+/** `lsof -a -d cwd -Fpn -p <pids>` の出力を pid → cwd へパースする。 */
+export function parseLsofCwdOutput(output) {
+    const cwds = new Map();
+    let pid = null;
+    for (const line of output.split("\n")) {
+        if (line.startsWith("p")) {
+            pid = Number(line.slice(1));
+            continue;
+        }
+        if (line.startsWith("n") && pid !== null) {
+            cwds.set(pid, line.slice(1));
+        }
+    }
+    return cwds;
+}
+async function fetchCwds(pids) {
+    if (pids.length === 0)
+        return { ok: true, cwds: new Map() };
+    const result = await run("lsof", ["-a", "-d", "cwd", "-Fpn", "-p", pids.join(",")]);
+    return { ok: result.ok, cwds: parseLsofCwdOutput(result.stdout) };
+}
+async function fetchCommandLines(pids) {
+    if (pids.length === 0)
+        return new Map();
+    const result = await run("ps", ["-o", "pid=,command=", "-p", pids.join(",")]);
+    const lines = new Map();
+    for (const row of result.stdout.split("\n")) {
+        const match = /^\s*(\d+)\s+(.+)$/.exec(row);
+        if (match === null)
+            continue;
+        const commandLine = match[2].trim();
+        lines.set(Number(match[1]), commandLine.length > COMMAND_LINE_LIMIT
+            ? `${commandLine.slice(0, COMMAND_LINE_LIMIT)}…`
+            : commandLine);
+    }
+    return lines;
+}
+/**
+ * HTML 断片から `<title>` の中身を取り出す。空・見つからない場合は null。
+ * 表示用に空白を畳み、基本的な文字参照を復号して TITLE_LIMIT で切り詰める。
+ */
+export function parseHtmlTitle(html) {
+    const match = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+    if (match === null)
+        return null;
+    const title = match[1]
+        .replace(/&#x([0-9a-f]+);/gi, (_, hex) => String.fromCodePoint(parseInt(hex, 16)))
+        .replace(/&#(\d+);/g, (_, dec) => String.fromCodePoint(Number(dec)))
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, "&")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (title.length === 0)
+        return null;
+    // サロゲートペア（絵文字等）を割らないようコードポイント単位で切り詰める。
+    const points = [...title];
+    return points.length > TITLE_LIMIT ? `${points.slice(0, TITLE_LIMIT).join("")}…` : title;
+}
+/**
+ * loopback の HTTP GET でページ title を 1 ポートぶん取得する。失敗は null。
+ * `[::1]` のみで LISTEN するサーバーにも当たるよう IPv4/IPv6 両 loopback を並行試行する。
+ */
+async function probeTitle(port) {
+    const results = await Promise.all([
+        probeTitleAt(`http://127.0.0.1:${port}/`),
+        probeTitleAt(`http://[::1]:${port}/`),
+    ]);
+    return results.find((title) => title !== null) ?? null;
+}
+async function probeTitleAt(url) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TITLE_FETCH_TIMEOUT_MS);
+    try {
+        const response = await fetch(url, {
+            signal: controller.signal,
+            headers: { accept: "text/html" },
+        });
+        const contentType = response.headers.get("content-type") ?? "";
+        // content-type 未設定の簡易サーバーは HTML の可能性を残して読む。
+        if (contentType !== "" && !contentType.toLowerCase().includes("html")) {
+            await response.body?.cancel().catch(() => { });
+            return null;
+        }
+        if (response.body === null)
+            return null;
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let html = "";
+        while (html.length < TITLE_BODY_LIMIT) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            html += decoder.decode(value, { stream: true });
+            if (/<\/title>/i.test(html))
+                break;
+        }
+        await reader.cancel().catch(() => { });
+        return parseHtmlTitle(html);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** 各ポートの HTML title を並列取得する（全体は TITLE_FETCH_TIMEOUT_MS で頭打ち）。 */
+async function fetchTitles(ports) {
+    const titles = new Map();
+    await Promise.all(ports.map(async (port) => {
+        const title = await probeTitle(port);
+        if (title !== null)
+            titles.set(port, title);
+    }));
+    return titles;
+}
+/**
+ * 一覧と検出成否を返す。reaper は `ok=false` を「サーバーなし」とみなさず回収を延期する。
+ */
+export async function listServeProcessesWithStatus(options = {}) {
+    const excluded = new Set(options.excludePids ?? []);
+    const listen = await run("lsof", ["-nP", "-iTCP", "-sTCP:LISTEN", "-Fpcn"]);
+    const entries = parseLsofListenOutput(listen.stdout)
+        .filter((entry) => !excluded.has(entry.pid));
+    const pids = [...new Set(entries.map((entry) => entry.pid))];
+    const [cwdResult, commandLines] = await Promise.all([fetchCwds(pids), fetchCommandLines(pids)]);
+    const servers = entries
+        .map((entry) => {
+        const cwd = cwdResult.cwds.get(entry.pid);
+        return {
+            pid: entry.pid,
+            port: entry.port,
+            command: entry.command,
+            ...(commandLines.has(entry.pid) ? { commandLine: commandLines.get(entry.pid) } : {}),
+            ...(cwd !== undefined ? { cwd } : {}),
+        };
+    })
+        // cwd "/" は launchd 起動アプリ・デーモン（dev サーバーは実 cwd を持つ）。
+        // cwd 不明（取得失敗）は残す — 情報不足を理由に隠さない。
+        .filter((entry) => entry.cwd !== "/")
+        .sort((lhs, rhs) => lhs.port - rhs.port);
+    if (options.withTitles === true && servers.length > 0) {
+        const titles = await fetchTitles([...new Set(servers.map((server) => server.port))]);
+        for (const server of servers) {
+            const title = titles.get(server.port);
+            if (title !== undefined)
+                server.title = title;
+        }
+    }
+    return { ok: listen.ok && cwdResult.ok, servers };
+}
+/** 従来の一覧 API。UI/停止処理は失敗時も取得できた部分結果を表示する。 */
+export async function listServeProcesses(options = {}) {
+    return (await listServeProcessesWithStatus(options)).servers;
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForExit(pid, graceMs) {
+    const deadline = Date.now() + graceMs;
+    while (Date.now() < deadline) {
+        if (!isAlive(pid))
+            return true;
+        await sleep(POLL_INTERVAL_MS);
+    }
+    return !isAlive(pid);
+}
+/**
+ * pid のサーバーを停止する。pid 再利用の誤爆を防ぐため、その pid が今も
+ * 指定 port で LISTEN していることを確認してから SIGTERM → SIGKILL する。
+ */
+export async function stopServeProcess(pid, port) {
+    if (!Number.isInteger(pid) || pid <= 1) {
+        return { ok: false, error: `不正な pid: ${pid}` };
+    }
+    if (pid === process.pid) {
+        return { ok: false, error: "host 自身は停止できません" };
+    }
+    const current = await listServeProcesses();
+    const target = current.find((entry) => entry.pid === pid && entry.port === port);
+    if (target === undefined) {
+        return { ok: false, error: "対象のサーバーが見つかりません（すでに停止済み？）" };
+    }
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch (error) {
+        return { ok: false, error: `停止に失敗しました: ${String(error)}` };
+    }
+    if (await waitForExit(pid, TERM_GRACE_MS))
+        return { ok: true, error: null };
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        // SIGTERM 後に自然終了したレース。生存確認へ進む。
+    }
+    if (await waitForExit(pid, KILL_GRACE_MS))
+        return { ok: true, error: null };
+    return { ok: false, error: "プロセスが終了しませんでした" };
+}
+//# sourceMappingURL=serveService.js.map