walover-line-harness-gui 0.1.0

package/src/server/state.js

@@ -0,0 +1,178 @@
+/**
+ * セッション状態。**プロセスのメモリ上にのみ保持する。**
+ *
+ * LINE のチャネルシークレット / アクセストークンをここで扱うため、
+ * 以下を守ること:
+ *   - ディスクに書かない（ファイル・ログ・DB のいずれにも）
+ *   - プロセス終了とともに破棄する
+ *   - 外部に送らない（このサーバーは localhost にしか bind しない）
+ *   - **API 応答に値を含めない**（入力済みかどうかだけを返す）
+ */
+
+import { SetupRun } from "./runner.js";
+import {
+  FORM_FIELDS,
+  FORM_GROUPS,
+  SECRET_FIELDS,
+  PROMPTS,
+  CONTRACT_CLI_VERSION,
+  validateAnswer,
+  crossCheckAnswers,
+} from "./prompt-contract.js";
+import { guideFor, GUIDE } from "./guide.js";
+
+/** @type {{ answers: Record<string, string|boolean>, run: SetupRun|null }} */
+const state = {
+  /** フォームに入った値。ここから外に出すのは「入っているかどうか」だけ */
+  answers: Object.create(null),
+  /** 実行中のセットアップ */
+  run: null,
+};
+
+/**
+ * フォームの値を受け取る。**値はここから先に出さない。**
+ *
+ * 画面でも検証するが、ここでも同じ規則で見る。画面を通さずに投げられる以上、
+ * 「不正な値を本家に渡さない」を画面側の善意に任せてはいけない。
+ *
+ * @param {Record<string, unknown>} values
+ * @returns {{ accepted: string[], rejected: Record<string, string> }}
+ */
+export function setAnswers(values) {
+  const known = new Set(FORM_FIELDS.map((f) => f.field));
+  const accepted = [];
+  /** @type {Record<string, string>} */
+  const rejected = {};
+
+  for (const [key, value] of Object.entries(values)) {
+    // 契約に無い欄は受け取らない（そのまま本家に流れる経路を作らない）
+    if (!known.has(key)) continue;
+
+    const problem = validateAnswer(key, value);
+    if (problem !== null) {
+      // 通らなかった値は**保持しない**
+      rejected[key] = problem;
+      continue;
+    }
+
+    state.answers[key] = /** @type {string|boolean} */ (value);
+    accepted.push(key);
+  }
+
+  state.run?.setAnswers(state.answers);
+  return { accepted, rejected };
+}
+
+/** 項目をまたいだ問題。値は含まない */
+export function answerProblems() {
+  return crossCheckAnswers(state.answers);
+}
+
+/** 入力済みの欄。**値は含めない** */
+export function filledFields() {
+  return Object.entries(state.answers)
+    .filter(([, v]) => v !== undefined && v !== "")
+    .map(([k]) => k);
+}
+
+/** #2 のフォームが参照する、入力欄の定義。値は一切含まない */
+export function formSchema() {
+  return {
+    cliVersion: CONTRACT_CLI_VERSION,
+    groups: FORM_GROUPS,
+    fields: FORM_FIELDS.map((f) => {
+      const spec = PROMPTS.find((p) => p.id === f.promptId);
+      return {
+        field: f.field,
+        promptId: f.promptId,
+        kind: f.kind,
+        secret: f.secret,
+        group: f.group,
+        // 画面用のラベル。無ければ本家の文言をそのまま使う。
+        // 照合に使うのは message のほうなので、ここは読みやすさを優先してよい
+        label: spec?.formLabel ?? spec?.message ?? f.field,
+        hint: spec?.formHint ?? null,
+        placeholder: spec?.placeholder ?? null,
+        note: spec?.note ?? null,
+        // 「この値はどこで取るか」。資産は配布キット側を参照する
+        guide: guideFor(f.promptId),
+        optional: f.validation?.optional === true,
+        pattern: f.validation?.pattern ?? null,
+        minLength: f.validation?.minLength ?? null,
+        message: f.validation?.message ?? null,
+      };
+    }),
+  };
+}
+
+/**
+ * 起動してよいのは本家 CLI だけ。API の本文から任意のパッケージを
+ * 走らせられる経路を作らない。
+ */
+const CLI_SPEC = /^create-line-harness@(?:\d+\.\d+\.\d+|latest)$/;
+
+/** @param {{ cliSpec?: string }} [options] */
+export function startRun(options) {
+  if (options?.cliSpec && !CLI_SPEC.test(options.cliSpec)) {
+    throw new Error("起動できるのは本家 CLI だけです");
+  }
+
+  // 取り違えたまま始めると、片方のチャネルの ID が
+  // もう片方として Cloudflare に書き込まれる。始める前に止める
+  const problems = crossCheckAnswers(state.answers);
+  const first = Object.values(problems)[0];
+  if (first) throw new Error(first);
+
+  if (state.run && state.run.status !== "finished") {
+    throw new Error("すでにセットアップが動いています");
+  }
+  // 前回の run が持っていたシークレットの写しを先に捨てる
+  state.run?.dispose();
+
+  const run = new SetupRun(options);
+  run.setAnswers(state.answers);
+
+  // start() は擬似端末を用意できないと同期で投げる。
+  // 先に state.run へ入れてしまうと、status が "running" のまま
+  // pty が無い run が residue として残り、以後 start も stop も
+  // 受け付けなくなる（プロセスを立て直すまで復旧しない）
+  try {
+    run.start();
+  } catch (err) {
+    run.dispose();
+    throw err;
+  }
+
+  state.run = run;
+  return run;
+}
+
+/** 実行中に人が答える場面でも同じ案内を引けるようにする */
+export function guideMap() {
+  return GUIDE;
+}
+
+export function currentRun() {
+  return state.run;
+}
+
+/** 画面に返してよい形。**値は含めず、入力済みかどうかだけ** */
+export function publicSnapshot() {
+  return {
+    filledFields: filledFields(),
+    problems: crossCheckAnswers(state.answers),
+    secretFields: [...SECRET_FIELDS],
+    running: state.run !== null && state.run.status !== "finished",
+    run: state.run?.state() ?? null,
+  };
+}
+
+/** 破棄。プロセス終了時と、明示的なリセット時に呼ぶ */
+export function clear() {
+  state.run?.dispose();
+  state.run = null;
+  for (const key of Object.keys(state.answers)) {
+    state.answers[key] = "";
+    delete state.answers[key];
+  }
+}

package/src/server/static.js

@@ -0,0 +1,46 @@
+import { createReadStream } from "node:fs";
+import { stat } from "node:fs/promises";
+import { join, normalize, extname } from "node:path";
+
+const MIME = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".webp": "image/webp",
+  ".ico": "image/x-icon",
+};
+
+/**
+ * webRoot 配下だけを配信する。
+ * パストラバーサル（../ による外部参照）は正規化後の接頭辞チェックで弾く。
+ */
+export async function serveStatic(req, res, webRoot) {
+  const urlPath = new URL(req.url, "http://localhost").pathname;
+  const rel = urlPath === "/" ? "index.html" : decodeURIComponent(urlPath).replace(/^\/+/, "");
+  const target = normalize(join(webRoot, rel));
+
+  if (!target.startsWith(webRoot)) {
+    res.writeHead(403).end("Forbidden");
+    return true;
+  }
+
+  try {
+    const info = await stat(target);
+    if (!info.isFile()) return false;
+
+    res.writeHead(200, {
+      "Content-Type": MIME[extname(target)] ?? "application/octet-stream",
+      "Content-Length": info.size,
+      // 手元ツールなのでキャッシュさせない（開発中の取り違えを防ぐ）
+      "Cache-Control": "no-store",
+    });
+    createReadStream(target).pipe(res);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/server/terminal.js

@@ -0,0 +1,210 @@
+/**
+ * 極小の仮想端末。
+ *
+ * 本家 CLI は `@clack/prompts` を使っており、1文字入力するたびに
+ * 「カーソルを戻す → 行を消す → 書き直す」を繰り返す。
+ * そのため PTY から届くバイト列をそのまま連結すると、
+ * 入力途中の値が何度も混ざった別物になり、プロンプトの判定に使えない。
+ *
+ * ここでは clack が実際に使うエスケープだけを解釈して、
+ * **いま画面に見えている状態**を行の配列として復元する。
+ * （実測: CUU/CUD/CUF/CUB `A B C D` / CHA `G` / EL `K` / ED `J` / SGR `m` / DECTCEM `?25l ?25h`）
+ *
+ * 表示にも判定にも、この復元結果だけを使う。生のバイト列は外に出さない。
+ */
+
+const DEFAULT_MAX_LINES = 2000;
+
+export class Terminal {
+  /** @param {{ maxLines?: number }} [options] */
+  constructor(options = {}) {
+    this.maxLines = options.maxLines ?? DEFAULT_MAX_LINES;
+    /** @type {string[]} */
+    this.lines = [""];
+    this.row = 0;
+    this.col = 0;
+    /** 先頭から捨てた行数。呼び出し側が差分を追うために使う */
+    this.discarded = 0;
+    this.pending = "";
+  }
+
+  /** @param {string} chunk */
+  write(chunk) {
+    // 直前の write が escape の途中で切れている場合があるので継ぎ足す
+    let input = this.pending + chunk;
+    this.pending = "";
+    let i = 0;
+
+    while (i < input.length) {
+      const ch = input[i];
+
+      if (ch === "\x1b") {
+        const consumed = this.#escape(input, i);
+        if (consumed === -1) {
+          // まだ全部届いていない。次の chunk と合わせて解釈する
+          this.pending = input.slice(i);
+          return;
+        }
+        i += consumed;
+        continue;
+      }
+
+      if (ch === "\n") {
+        this.#down(1);
+        i += 1;
+        continue;
+      }
+      if (ch === "\r") {
+        this.col = 0;
+        i += 1;
+        continue;
+      }
+      if (ch === "\b") {
+        this.col = Math.max(0, this.col - 1);
+        i += 1;
+        continue;
+      }
+      if (ch === "\x07") {
+        i += 1;
+        continue;
+      }
+
+      // 制御文字以外はそのまま上書きで置く
+      this.#put(ch);
+      i += 1;
+    }
+
+    this.#trim();
+  }
+
+  /**
+   * ESC から始まる並びを1つ消費する。
+   * @returns {number} 消費した文字数。未完なら -1
+   */
+  #escape(input, start) {
+    const next = input[start + 1];
+    if (next === undefined) return -1;
+
+    // OSC: ESC ] ... BEL | ESC \
+    if (next === "]") {
+      for (let i = start + 2; i < input.length; i += 1) {
+        if (input[i] === "\x07") return i - start + 1;
+        if (input[i] === "\x1b" && input[i + 1] === "\\") return i - start + 2;
+      }
+      return -1;
+    }
+
+    // CSI: ESC [ params intermediate final
+    if (next === "[") {
+      let i = start + 2;
+      while (i < input.length && /[\d;?]/.test(input[i])) i += 1;
+      if (i >= input.length) return -1;
+      const final = input[i];
+      const params = input.slice(start + 2, i);
+      this.#csi(final, params);
+      return i - start + 1;
+    }
+
+    // それ以外の 2 文字エスケープは読み飛ばす
+    return 2;
+  }
+
+  #csi(final, params) {
+    if (params.startsWith("?")) return; // ?25l / ?25h など。表示状態は持たない
+
+    const nums = params.split(";").map((p) => (p === "" ? undefined : Number(p)));
+    const n = nums[0] ?? 1;
+
+    switch (final) {
+      case "A": // カーソル上
+        this.row = Math.max(0, this.row - n);
+        break;
+      case "B": // カーソル下
+        this.#down(n);
+        break;
+      case "C": // カーソル右
+        this.col += n;
+        break;
+      case "D": // カーソル左
+        this.col = Math.max(0, this.col - n);
+        break;
+      case "G": // 桁指定（clack は 1 桁目に戻すのに使う）
+        this.col = Math.max(0, (nums[0] ?? 1) - 1);
+        break;
+      case "K": // 行内消去
+        this.#eraseLine(nums[0] ?? 0);
+        break;
+      case "J": // 画面消去
+        this.#eraseDisplay(nums[0] ?? 0);
+        break;
+      default:
+        // m（色）を含め、表示に影響しないものは捨てる
+        break;
+    }
+  }
+
+  #down(n) {
+    this.row += n;
+    while (this.lines.length <= this.row) this.lines.push("");
+  }
+
+  #put(ch) {
+    const line = this.lines[this.row] ?? "";
+    const padded = line.length < this.col ? line + " ".repeat(this.col - line.length) : line;
+    this.lines[this.row] = padded.slice(0, this.col) + ch + padded.slice(this.col + 1);
+    this.col += 1;
+  }
+
+  #eraseLine(mode) {
+    const line = this.lines[this.row] ?? "";
+    if (mode === 1) {
+      this.lines[this.row] = " ".repeat(Math.min(this.col, line.length)) + line.slice(this.col);
+    } else if (mode === 2) {
+      this.lines[this.row] = "";
+    } else {
+      this.lines[this.row] = line.slice(0, this.col);
+    }
+  }
+
+  #eraseDisplay(mode) {
+    if (mode === 2) {
+      // 画面全消し。捨てた分を数えておかないと行番号が振り直しになり、
+      // 呼び出し側が「同じ枠」と誤認する（応答済み判定が別の枠に当たる）
+      this.discarded += this.lines.length;
+      this.lines = [""];
+      this.row = 0;
+      this.col = 0;
+      return;
+    }
+    if (mode === 1) {
+      this.lines[this.row] = " ".repeat(this.col);
+      for (let i = 0; i < this.row; i += 1) this.lines[i] = "";
+      return;
+    }
+    // mode 0: カーソル位置から画面末尾まで
+    this.lines[this.row] = (this.lines[this.row] ?? "").slice(0, this.col);
+    this.lines.length = this.row + 1;
+  }
+
+  #trim() {
+    const excess = this.lines.length - this.maxLines;
+    if (excess <= 0) return;
+    this.lines.splice(0, excess);
+    this.discarded += excess;
+    this.row = Math.max(0, this.row - excess);
+  }
+
+  /** いま見えている行。末尾の空行は落とす */
+  snapshot() {
+    const out = this.lines.slice();
+    let end = out.length;
+    while (end > 0 && out[end - 1].trim() === "") end -= 1;
+    return out.slice(0, end).map((l) => l.replace(/\s+$/, ""));
+  }
+
+  /** @param {number} n */
+  tail(n) {
+    const lines = this.snapshot();
+    return lines.slice(Math.max(0, lines.length - n));
+  }
+}