walover-line-harness-gui 0.1.0

package/src/server/prompt-contract.js

@@ -0,0 +1,373 @@
+/**
+ * プロンプト契約。
+ *
+ * 本家 `create-line-harness` が出すプロンプトの**文言そのもの**を並べたもの。
+ * 一次情報は本家 npm パッケージのバンドル（dist/index.js）から逐語で取っている。
+ * 対象バージョンは {@link CONTRACT_CLI_VERSION}。
+ *
+ * ## なぜ順番でマッチさせないか
+ *
+ * 本家のバージョンアップでプロンプトが1つ増えるだけで、順番マッチは値を1つずつズラす。
+ * 最悪の場合チャネルシークレットがプロジェクト名の欄に入り、画面にエコーされ、
+ * Worker 名として Cloudflare に残る。機能不全ではなく情報漏洩になる。
+ *
+ * そのため:
+ *   - 文言が**完全一致**したときだけ応答する
+ *   - placeholder を宣言しているものは、それも一致することを要求する（第二の照合）
+ *   - 一致しなければ**止めて人間に委ねる**（フェイルクローズ）
+ *
+ * ## `Channel ID（数字）` と `チャネル ID（数字）`
+ *
+ * この2つは Messaging API チャネルと LINE Login チャネルで**別物**なのに、
+ * 見た目がほとんど同じ。placeholder が違うので、そこを第二の照合に使う。
+ */
+
+/** 契約が対象とする本家 CLI のバージョン。ズレの検知は #5 で行う */
+export const CONTRACT_CLI_VERSION = "0.2.11";
+
+/**
+ * @typedef {object} PromptSpec
+ * @property {string} id                    契約上の識別子
+ * @property {string} message               本家が出す文言（完全一致）
+ * @property {"text"|"select"|"confirm"} kind
+ * @property {string} [placeholder]         宣言した場合、初期表示の値行と完全一致することを要求する
+ * @property {string[]} [optionLabels]      select の選択肢（完全一致）。動的なものは省略する
+ * @property {boolean} [secret]             画面表示から伏せる対象か
+ * @property {"form"|"human"} answer        form=参加者が先に入力した値で応答 / human=その場で人が決める
+ * @property {string} [field]               answer=form のときの入力欄 id
+ * @property {string} [askLabel]            実行中に人へ問うときの見出し。
+ *   本家の文言は端末を前提にしているので（例:「Enter を押してください」）、
+ *   そのまま出すと画面に無い操作を指示してしまう
+ * @property {string} [note]                GUI に出す補足
+ */
+
+/** @type {PromptSpec[]} */
+export const PROMPTS = [
+  // ── 再開時（前回のステートが残っている場合のみ）──────────────────────
+  {
+    id: "resumeAccountUnknown",
+    message: "どうしますか？",
+    askLabel: "前回のリソースをどう扱いますか？",
+    kind: "select",
+    optionLabels: [
+      "アカウント依存ステップをリセットして、現在のアカウントで作り直す（推奨）",
+      "リセットせず、現在のアカウントで続行する（前回のリソースが流用できれば再利用）",
+      "中止する",
+    ],
+    answer: "human",
+    note: "前回作った Cloudflare リソースがどのアカウントのものか記録されていません。作り直すか続行するかを選んでください。",
+  },
+  {
+    id: "accountChanged",
+    message: "どうしますか？",
+    askLabel: "別の Cloudflare アカウントで続けますか？",
+    kind: "select",
+    optionLabels: [
+      "現在ログイン中のアカウントで続行する（R2/D1/Worker などを作り直し）",
+      "中止して `wrangler login` で前回のアカウントに戻る",
+    ],
+    answer: "human",
+    note: "前回と違う Cloudflare アカウントでログインしています。作り直すか、中止して元のアカウントに戻るかを選んでください。",
+  },
+
+  // ── Cloudflare アカウント選択（複数アカウントがある場合のみ）──────────
+  {
+    id: "cloudflareAccount",
+    message: "使用する Cloudflare アカウントを選択してください",
+    askLabel: "どの Cloudflare アカウントに作りますか？",
+    kind: "select",
+    // 選択肢は `${name} (${id})` で動的。契約では固定しない
+    answer: "human",
+    note: "どの Cloudflare アカウントに作るかを選んでください。",
+  },
+
+  // ── Step 1. R2 の有効化待ち ───────────────────────────────────────────
+  {
+    id: "r2Enabled",
+    message: "R2 の有効化が完了したら Enter を押してください",
+    // 本家は端末で Enter を待つが、この画面に Enter は無い。
+    // 文言をそのまま出すと「押さないと進めない」と読まれる（実機で混乱を確認）
+    askLabel: "R2 の有効化は終わりましたか？",
+    kind: "text",
+    answer: "human",
+    note: "Cloudflare ダッシュボードで R2 を有効化してから進めてください。カード登録済みでも R2 の利用開始は別操作です。",
+  },
+
+  // ── Step 1 の続き。プロジェクト名 ─────────────────────────────────────
+  {
+    id: "projectName",
+    message: "プロジェクト名（Worker と D1 の名前に使われます）",
+    formLabel: "プロジェクト名",
+    formHint: "Worker と D1 の名前になります。空のままにすると line-harness になります。",
+    kind: "text",
+    placeholder: "line-harness",
+    answer: "form",
+    field: "projectName",
+    group: "project",
+    validation: {
+      optional: true, // 空なら本家が line-harness を使う
+      pattern: "^[a-z0-9][a-z0-9-]*$",
+      message: "英小文字・数字・ハイフンのみ使用できます（例: my-line-bot）",
+    },
+  },
+
+  // ── Step 2. Messaging API チャネル ───────────────────────────────────
+  {
+    id: "lineChannelId",
+    message: "Channel ID（数字）",
+    // 下の「チャネル ID（数字）」と文言がほとんど同じで、実測で最大の混乱要因だった。
+    // 画面ではどちらのチャネルのものかをラベル自体に入れる
+    formLabel: "Channel ID（Messaging API チャネル）",
+    kind: "text",
+    placeholder: "上の手順で取得した Channel ID",
+    answer: "form",
+    field: "lineChannelId",
+    group: "messaging",
+    validation: {
+      trim: true,
+      pattern: "^\\d+$",
+      message: "Channel ID は数字で入力してください",
+    },
+  },
+  {
+    id: "lineChannelSecret",
+    message: "チャネルシークレット（英数字）",
+    kind: "text",
+    placeholder: "同じページに表示されている Channel Secret",
+    secret: true,
+    answer: "form",
+    field: "lineChannelSecret",
+    group: "messaging",
+    validation: {
+      trim: true,
+      minLength: 10,
+      message: "チャネルシークレットを入力してください",
+    },
+  },
+  {
+    id: "lineChannelAccessToken",
+    message: "チャネルアクセストークン（長期）",
+    kind: "text",
+    placeholder: "上の手順で発行したトークン",
+    secret: true,
+    answer: "form",
+    field: "lineChannelAccessToken",
+    group: "messaging",
+    validation: {
+      trim: true,
+      minLength: 10,
+      message: "チャネルアクセストークンを入力してください",
+    },
+  },
+
+  // ── Step 3. LINE Login チャネル ──────────────────────────────────────
+  // 上の lineChannelId と文言が紛らわしい。placeholder で区別する
+  {
+    id: "lineLoginChannelId",
+    message: "チャネル ID（数字）",
+    formLabel: "チャネル ID（LINE Login チャネル）",
+    kind: "text",
+    placeholder: "LINE Login チャネルの ID（Messaging API とは別）",
+    answer: "form",
+    field: "lineLoginChannelId",
+    group: "login",
+    validation: {
+      trim: true,
+      pattern: "^\\d+$",
+      message: "チャネル ID は数字で入力してください",
+    },
+  },
+  {
+    id: "liffId",
+    message: "LIFF ID",
+    formHint: "LINE Login チャネルの「LIFF」タブで作成したアプリの ID です。",
+    kind: "text",
+    placeholder: "チャネルID-ランダム文字列（例: 2009554425-4IMBmLQ9）",
+    answer: "form",
+    field: "liffId",
+    group: "login",
+    validation: {
+      trim: true,
+      // 本家は「- を含むか」しか見ていない。ここを厳しくすると正しい値を弾く
+      pattern: "^.*-.*$",
+      message: "LIFF ID は「チャネルID-ランダム文字列」の形式です（例: 2009554425-4IMBmLQ9）",
+    },
+  },
+
+  // ── workers.dev サブドメイン（未設定のときだけ）──────────────────────
+  {
+    id: "workersSubdomain",
+    message:
+      "workers.dev サブドメイン名（Worker の URL が https://<Worker名>.<この名前>.workers.dev になります）",
+    formLabel: "workers.dev サブドメイン名",
+    formHint: "Worker の URL が https://<Worker名>.<この名前>.workers.dev になります。",
+    kind: "text",
+    // placeholder は本家が候補名を動的に入れるため固定しない
+    answer: "form",
+    field: "workersSubdomain",
+    group: "project",
+    validation: {
+      optional: true, // 設定済みなら本家は聞いてこない
+      trim: true,
+      pattern: "^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$",
+      message: "英小文字・数字・ハイフンのみ、63文字以内、先頭と末尾は英数字にしてください",
+    },
+    note: "workers.dev サブドメインは全世界で早い者勝ちです。重複すると本家が再入力を求めます。",
+  },
+  {
+    id: "subdomainManualCheck",
+    message: "ダッシュボードでの登録が終わったら「確認する」を選んでください",
+    askLabel: "サブドメインの登録は終わりましたか？",
+    kind: "select",
+    optionLabels: [
+      "確認する（登録済みかチェックします）",
+      "確認せずに続行する（未登録だとデプロイに失敗します）",
+    ],
+    answer: "human",
+    note: "CLI からの自動登録ができませんでした。ダッシュボードで登録してから「確認する」を選んでください。",
+  },
+
+  // ── 仕上げ ───────────────────────────────────────────────────────────
+  {
+    id: "addMcp",
+    message: "MCP 設定を .mcp.json に追加しますか？（Claude Code / Cursor 用）",
+    formLabel: "MCP 設定を .mcp.json に追加する（Claude Code / Cursor 用）",
+    kind: "confirm",
+    answer: "form",
+    field: "addMcp",
+    group: "options",
+  },
+];
+
+/**
+ * フォームの区切り。
+ *
+ * **Messaging API チャネルと LINE Login チャネルは別物**なのに、
+ * 本家の文言（`Channel ID（数字）` と `チャネル ID（数字）`）はほとんど同じ。
+ * 実測でも最大の混乱要因だったので、画面では取得元ごとに分けて見せる。
+ */
+export const FORM_GROUPS = [
+  {
+    id: "project",
+    title: "プロジェクト",
+    description: "Cloudflare 上に作られるものの名前です。あとから変えられません。",
+  },
+  {
+    id: "messaging",
+    title: "Messaging API チャネル",
+    description:
+      "LINE Official Account Manager の「Messaging API」画面で取得します。次の Login チャネルとは別物です。",
+  },
+  {
+    id: "login",
+    title: "LINE Login チャネル",
+    description:
+      "LINE Developers Console で新規作成した「LINEログイン」チャネルです。上の Messaging API チャネルとは別物です。",
+  },
+  { id: "options", title: "オプション", description: null },
+];
+
+/**
+ * 入力値がそのまま本家に渡せるかを見る。
+ *
+ * 規則は**本家の validate をそのまま写したもの**。
+ * ここを本家より厳しくすると、正しい値を弾いて参加者が進めなくなる。
+ * 文言も本家に合わせてあるので、GUI で弾いても CLI で弾いても同じことを言う。
+ *
+ * @param {string} field
+ * @param {unknown} value
+ * @returns {string|null} 問題があれば文言、無ければ null
+ */
+export function validateAnswer(field, value) {
+  const spec = PROMPTS.find((p) => p.field === field && p.answer === "form");
+  if (!spec) return "この項目は受け付けていません";
+
+  if (spec.kind === "confirm") {
+    return typeof value === "boolean" ? null : "はい / いいえ で答えてください";
+  }
+
+  if (typeof value !== "string") return "文字で入力してください";
+
+  const rule = spec.validation;
+  if (!rule) return null;
+
+  const text = rule.trim ? value.trim() : value;
+
+  if (text === "") return rule.optional ? null : rule.message;
+  if (rule.minLength !== undefined && text.length < rule.minLength) return rule.message;
+  if (rule.pattern !== undefined && !new RegExp(rule.pattern).test(text)) return rule.message;
+
+  return null;
+}
+
+/**
+ * 項目をまたいだ確認。
+ *
+ * Messaging API チャネルと LINE Login チャネルは**別のチャネル**なので、
+ * Channel ID が一致することはない。同じ値が入っていたら取り違えている。
+ * 本家はこれを見ていないため、気づかないまま最後まで進んでしまう。
+ *
+ * @param {Record<string, string|boolean>} answers
+ * @returns {Record<string, string>} 欄ごとの問題
+ */
+export function crossCheckAnswers(answers) {
+  /** @type {Record<string, string>} */
+  const problems = {};
+
+  const messaging = typeof answers.lineChannelId === "string" ? answers.lineChannelId.trim() : "";
+  const login =
+    typeof answers.lineLoginChannelId === "string" ? answers.lineLoginChannelId.trim() : "";
+
+  if (messaging !== "" && messaging === login) {
+    const message =
+      "Messaging API チャネルと LINE Login チャネルは別のチャネルです。同じ ID にはなりません。取得元をもう一度確認してください。";
+    problems.lineChannelId = message;
+    problems.lineLoginChannelId = message;
+  }
+
+  return problems;
+}
+
+/** answer=form のプロンプトが要求する入力欄。#2 のフォームはこれに合わせる */
+export const FORM_FIELDS = PROMPTS.filter((p) => p.answer === "form").map((p) => ({
+  field: /** @type {string} */ (p.field),
+  promptId: p.id,
+  kind: p.kind,
+  secret: p.secret === true,
+  group: p.group ?? "options",
+  validation: p.validation ?? null,
+}));
+
+/** 伏字にする入力欄 id */
+export const SECRET_FIELDS = new Set(
+  PROMPTS.filter((p) => p.secret === true && p.field).map((p) => /** @type {string} */ (p.field)),
+);
+
+/**
+ * 検出したプロンプトに一致する契約を返す。
+ *
+ * **一致しなければ null。**呼び出し側はそのとき自動応答を止めること。
+ *
+ * @param {{ message: string, kind: string, valueLine?: string, optionLabels?: string[] }} detected
+ * @returns {PromptSpec[]} 一致した契約。0 件なら未知、2 件以上なら曖昧
+ */
+export function matchPrompt(detected) {
+  return PROMPTS.filter((spec) => {
+    if (spec.message !== detected.message) return false;
+    if (spec.kind !== detected.kind) return false;
+
+    // placeholder を宣言しているものは、初期表示の値行と一致することを要求する
+    if (spec.placeholder !== undefined) {
+      if (detected.valueLine !== spec.placeholder) return false;
+    }
+
+    // 選択肢を宣言しているものは、画面の選択肢と完全一致することを要求する
+    if (spec.optionLabels !== undefined) {
+      const shown = detected.optionLabels ?? [];
+      if (shown.length !== spec.optionLabels.length) return false;
+      if (!spec.optionLabels.every((label, i) => shown[i] === label)) return false;
+    }
+
+    return true;
+  });
+}

package/src/server/prompt-detector.js

@@ -0,0 +1,181 @@
+/**
+ * `@clack/prompts` が描いた画面から、いま応答を待っているプロンプトを読み取る。
+ *
+ * clack の枠は実測でこの形（{@link Terminal} で復元したあとの平文）:
+ *
+ * ```
+ * │
+ * ◆  プロジェクト名（Worker と D1 の名前に使われます）
+ * │  line-harness
+ * └
+ * ```
+ *
+ * - `◆` = 入力待ち / `▲` = 入力エラーで再入力待ち
+ * - select は本文が1行1選択肢（`●` が現在位置）、confirm は `● Yes / ○ No` の1行
+ *
+ * ## 記号はログ行と共用されている（実測）
+ *
+ * clack の `log.*` は**プロンプトと同じ記号を使う**。
+ *
+ * | 呼び出し | 記号 |
+ * |---|---|
+ * | `log.success` | `◆` ← 入力待ちと同じ |
+ * | `log.warn`    | `▲` ← 入力エラーと同じ |
+ * | `log.step` / 確定済み | `◇` |
+ * | `log.error`   | `■` |
+ *
+ * 本家は `log.success("LIFF ID: 入力済み（…）")` のような行を多用し、最後に
+ * `outro()` が `└  セットアップ完了` を書く。素直に読むと、**成功して終わった実行の
+ * 最終画面が「入力待ちの枠」に見える**。
+ *
+ * 見分け方はこう:
+ *
+ * - 本物の入力待ちの枠は、**中身のない `└` で閉じる**。
+ *   `outro` / `cancel` の `└` には文言が付くので、そこで弾ける
+ * - `▲` が入力エラーなのかログなのかは画面だけでは決まらない。
+ *   **自分が答えた枠かどうか**で判断するので、それは {@link SetupRun} 側で見る
+ *
+ * ここは「読む」だけで、応答の可否は {@link matchPrompt} が決める。
+ */
+
+// clack は端末が unicode を扱えないときだけ ASCII の代替記号（* x | — > 空白）に落ちる。
+// pty.js で TERM=xterm-256color を固定しているので、この分岐には入らない。
+// 代替記号まで見に行くと `*  ` で始まる普通の出力をプロンプトと誤認するので、拾わない。
+const SYM_ACTIVE = ["◆"];
+const SYM_ERROR = ["▲"];
+const SYM_BAR = ["│"];
+const SYM_END = ["└"];
+const RADIO_ON = ["●"];
+const RADIO_OFF = ["○"];
+
+const anyOf = (chars) => `[${chars.map((c) => c.replace(/[\\\]^-]/g, "\\$&")).join("")}]`;
+
+const RE_HEAD = new RegExp(`^(${anyOf(SYM_ACTIVE)}|${anyOf(SYM_ERROR)})  (.*)$`);
+const RE_BAR = new RegExp(`^${anyOf(SYM_BAR)}(?:  (.*))?$`);
+const RE_END = new RegExp(`^${anyOf(SYM_END)}(?:  (.*))?$`);
+const RE_RADIO = new RegExp(`^(${anyOf(RADIO_ON)}|${anyOf(RADIO_OFF)}) (.*)$`);
+
+/** clack はカーソル位置に █ を描く。値の比較前に落とす */
+const stripCursor = (s) => s.replace(/█/g, "");
+
+/**
+ * @typedef {object} DetectedPrompt
+ * @property {"active"|"error"} state
+ * @property {string} message
+ * @property {"text"|"select"|"confirm"} kind
+ * @property {string} [valueLine]      text のとき、値（未入力なら placeholder）
+ * @property {string[]} [optionLabels] select / confirm の選択肢
+ * @property {number} [activeIndex]    select / confirm でいま選ばれている位置
+ * @property {string} [errorText]      state=error のときの本家のエラー文言
+ * @property {boolean} complete        枠が `└` まで届いているか
+ * @property {number} startLine        snapshot 上の開始行
+ */
+
+/**
+ * @param {string[]} lines {@link Terminal#snapshot} の結果
+ * @returns {DetectedPrompt|null}
+ */
+export function detectPrompt(lines) {
+  // 末尾から最初に見つかる ◆ / ▲ が、いま応答を待っている枠
+  let head = -1;
+  for (let i = lines.length - 1; i >= 0; i -= 1) {
+    if (RE_HEAD.test(lines[i])) {
+      head = i;
+      break;
+    }
+  }
+  if (head === -1) return null;
+
+  const m = RE_HEAD.exec(lines[head]);
+  if (!m) return null;
+  const state = SYM_ERROR.includes(m[1]) ? "error" : "active";
+
+  // 文言が端末幅を超えて折り返された場合、続きは接頭辞なしの行になる。
+  // （幅は 200 桁を確保しているので通常は起きない。起きたら結合が不正確になり、
+  //   契約と一致せず「未知のプロンプト」として止まる＝安全側に倒れる）
+  let messageParts = [m[2]];
+  let i = head + 1;
+  while (i < lines.length && !RE_BAR.test(lines[i]) && !RE_END.test(lines[i]) && !RE_HEAD.test(lines[i])) {
+    messageParts.push(lines[i]);
+    i += 1;
+  }
+  const message = stripCursor(messageParts.join("")).trim();
+
+  /** @type {string[]} */
+  const body = [];
+  let complete = false;
+  let endText;
+
+  for (; i < lines.length; i += 1) {
+    const end = RE_END.exec(lines[i]);
+    if (end) {
+      complete = true;
+      endText = end[1]?.trim() || undefined;
+      break;
+    }
+    const bar = RE_BAR.exec(lines[i]);
+    if (!bar) break;
+    body.push(bar[1] ?? "");
+  }
+
+  // 入力待ちの枠は中身のない `└` で閉じる。文言が付いていたら、それは
+  // `outro` / `cancel` が書いた行で、上にある `◆` は log.success のもの。
+  // 応答対象にしてはいけないので「まだ揃っていない」として扱う。
+  if (complete && state === "active" && endText !== undefined) {
+    complete = false;
+    endText = undefined;
+  }
+
+  const errorText = state === "error" ? endText : undefined;
+
+  // ── 種別の判定 ────────────────────────────────────────────────────
+  const radios = body.map((l) => RE_RADIO.exec(l.trim()));
+
+  // confirm: 1行に「● Yes / ○ No」
+  if (body.length === 1 && radios[0]) {
+    const parts = body[0].trim().split(/\s+\/\s+/);
+    if (parts.length === 2 && parts.every((p) => RE_RADIO.test(p))) {
+      const labels = parts.map((p) => /** @type {RegExpExecArray} */ (RE_RADIO.exec(p))[2].trim());
+      const activeIndex = parts.findIndex((p) =>
+        RADIO_ON.includes(/** @type {RegExpExecArray} */ (RE_RADIO.exec(p))[1]),
+      );
+      return {
+        state,
+        message,
+        kind: "confirm",
+        optionLabels: labels,
+        activeIndex: activeIndex === -1 ? undefined : activeIndex,
+        errorText,
+        complete,
+        startLine: head,
+      };
+    }
+  }
+
+  // select: 本文が全部「● / ○ + ラベル」
+  if (body.length > 0 && radios.every((r) => r !== null)) {
+    const labels = radios.map((r) => /** @type {RegExpExecArray} */ (r)[2].trim());
+    const activeIndex = radios.findIndex((r) => RADIO_ON.includes(/** @type {RegExpExecArray} */ (r)[1]));
+    return {
+      state,
+      message,
+      kind: "select",
+      optionLabels: labels,
+      activeIndex: activeIndex === -1 ? undefined : activeIndex,
+      errorText,
+      complete,
+      startLine: head,
+    };
+  }
+
+  // それ以外は text
+  return {
+    state,
+    message,
+    kind: "text",
+    valueLine: stripCursor(body[0] ?? "").trim(),
+    errorText,
+    complete,
+    startLine: head,
+  };
+}

package/src/server/pty-relay.py

@@ -0,0 +1,130 @@
+#!/usr/bin/env python3
+"""擬似端末（PTY）のリレー。
+
+本家 create-line-harness は @clack/prompts を使っており、実 TTY を要求する。
+通常のパイプで起動すると最初のプロンプトで落ちる:
+
+    Error: TTY initialization failed: uv_tty_init returned EINVAL
+
+Node には PTY を作る標準 API がない。node-pty は install script でネイティブ
+ビルドを行うが、npm 11 以降は install script が既定でブロックされるため、
+`npx` 配布ではバイナリが入らず**無言で壊れる**（実測済み）。
+そこで Python 標準ライブラリの `pty` だけで PTY を確保する。
+
+このスクリプトは中継しかしない:
+
+    親（Node）の stdin  → PTY → 子（本家 CLI）
+    子の出力           → PTY → 親の stdout
+
+**シークレットは argv にも一時ファイルにも置かない。**必ず stdin 経由で流すこと
+（argv は `ps` で他のプロセスから見える）。
+
+環境変数:
+    LH_PTY_ROWS / LH_PTY_COLS   端末の大きさ。既定 50x200。
+        clack は端末幅で枠を折り返すため、幅を十分に取って
+        プロンプト文言が折り返されないようにしている。
+"""
+
+import errno
+import fcntl
+import os
+import pty
+import select
+import signal
+import struct
+import sys
+import termios
+
+
+def _exit_code(status):
+    to_code = getattr(os, "waitstatus_to_exitcode", None)
+    if to_code is not None:
+        return to_code(status)
+    if os.WIFSIGNALED(status):
+        return 128 + os.WTERMSIG(status)
+    return os.WEXITSTATUS(status)
+
+
+def main():
+    argv = sys.argv[1:]
+    if not argv:
+        sys.stderr.write("usage: pty-relay.py <command> [args...]\n")
+        return 2
+
+    rows = int(os.environ.get("LH_PTY_ROWS") or 50)
+    cols = int(os.environ.get("LH_PTY_COLS") or 200)
+
+    pid, master = pty.fork()
+    if pid == 0:
+        # 子: そのまま本家 CLI になる
+        try:
+            os.execvp(argv[0], argv)
+        except Exception as exc:  # noqa: BLE001 - 子プロセスなのでここで終える
+            sys.stderr.write("pty-relay: exec failed: %s\n" % exc)
+        os._exit(127)
+
+    try:
+        fcntl.ioctl(master, termios.TIOCSWINSZ, struct.pack("HHHH", rows, cols, 0, 0))
+    except OSError:
+        pass
+
+    def forward(signum, _frame):
+        try:
+            os.kill(pid, signum)
+        except OSError:
+            pass
+
+    for sig in (signal.SIGTERM, signal.SIGINT, signal.SIGHUP):
+        try:
+            signal.signal(sig, forward)
+        except (ValueError, OSError):
+            pass
+
+    stdin_open = True
+    while True:
+        watch = [master] + ([0] if stdin_open else [])
+        try:
+            readable = select.select(watch, [], [])[0]
+        except OSError as exc:
+            if exc.errno == errno.EINTR:
+                continue
+            break
+        except InterruptedError:
+            continue
+
+        if master in readable:
+            try:
+                data = os.read(master, 65536)
+            except OSError:
+                data = b""
+            if not data:
+                break
+            os.write(1, data)
+
+        if stdin_open and 0 in readable:
+            try:
+                data = os.read(0, 65536)
+            except OSError:
+                data = b""
+            if not data:
+                stdin_open = False
+            else:
+                try:
+                    os.write(master, data)
+                except OSError:
+                    pass
+
+    try:
+        os.close(master)
+    except OSError:
+        pass
+
+    try:
+        status = os.waitpid(pid, 0)[1]
+    except OSError:
+        return 1
+    return _exit_code(status)
+
+
+if __name__ == "__main__":
+    sys.exit(main())