accompany 0.0.0-stage → 0.25.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Itsuki Yamada
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# accompany
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+AI コーディングエージェントのターミナルをブラウザで共有する Web UI サーバー。Bun（1.4.0 以上）があれば Bun で動き、なければ同梱の実行ファイルで動く（Bun を入れなくても起動できる）。
+
+```sh
+npx accompany              # 最初のターミナルで $SHELL を動かす
+npx accompany -- claude    # 最初のターミナルで動かすコマンドを指定する
+npx accompany --port 4000  # 待ち受けるポートを変える
+npx accompany --help       # 使い方を表示する
+```
+
+macOS（Apple Silicon・Intel）と Linux（x64・arm64、glibc）に対応する。Bun があっても実行ファイルで動かしたいときは、`ACCOMPANY_USE_BINARY=1` を付けて起動する。使い方の詳細は [GitHub](https://github.com/itsuki-yamada/accompany) を参照。

package/bin/accompany.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+// npm で入れた Accompany の起動役（docs/adr/132-npm.md、191-run-on-bun.md）。
+// Bun（1.4.0 以上）があれば、同梱した JS（dist/cli.js。Release の tarball と同じもの）を Bun で動かす。
+// 署名のない実行ファイルより、広く使われている Bun が動かすほうが、セキュリティの製品に止められにくいため。
+// Bun がなければ（または ACCOMPANY_USE_BINARY=1 を付けると）、このマシンの OS と CPU のパッケージ
+// （@itsuki-yamada/accompany-<OS>-<CPU>）に入っている実行ファイルを起動する。
+// 引数と標準入出力はそのまま渡す。止める合図は起動したものに伝え、その終了コード（または合図）で終わる。
+// Node の古い版でも動くよう、CommonJS と古くからある API だけを使う
+"use strict";
+
+const { spawn, spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const supported = ["darwin-arm64", "darwin-x64", "linux-x64", "linux-arm64"];
+const platform = `${process.platform}-${process.arch}`;
+const releases = "https://github.com/itsuki-yamada/accompany/releases";
+// app/server/src/require-bun.ts の required と同じ版。これより古い Bun では動かさず、実行ファイルを起動する
+const requiredBun = [1, 4, 0];
+const script = path.join(__dirname, "..", "dist", "cli.js");
+
+function fail(message) {
+  console.error(`Accompany: ${message}`);
+  process.exit(1);
+}
+
+// PATH の bun（起動役そのものを Bun が動かしているときは、その Bun）。見つからなければ undefined。
+// 相対のディレクトリ（. や空の要素など）は飛ばす。起動したディレクトリによって変わり、そこに置かれた bun を動かしてしまうため
+function findBun() {
+  if (process.versions.bun) return process.execPath;
+  for (const dir of (process.env.PATH || "").split(path.delimiter)) {
+    if (!path.isAbsolute(dir)) continue;
+    const file = path.join(dir, "bun");
+    try {
+      fs.accessSync(file, fs.constants.X_OK);
+      if (fs.statSync(file).isFile()) return file;
+    } catch {
+      // 次のディレクトリを探す
+    }
+  }
+  return undefined;
+}
+
+// bun の版が requiredBun 以上か
+function isNewEnough(bun) {
+  const result = spawnSync(bun, ["--version"], { encoding: "utf8", timeout: 10000 });
+  const match = /^(\d+)\.(\d+)\.(\d+)/.exec((result.stdout || "").trim());
+  if (result.status !== 0 || !match) return false;
+  for (let i = 0; i < 3; i++) {
+    const n = Number(match[i + 1]);
+    if (n !== requiredBun[i]) return n > requiredBun[i];
+  }
+  return true;
+}
+
+// 起動するもの（コマンドと、その前に付ける引数）
+function choose() {
+  if (process.env.ACCOMPANY_USE_BINARY !== "1" && fs.existsSync(script)) {
+    const bun = findBun();
+    if (bun && isNewEnough(bun)) return { command: bun, args: [script] };
+  }
+
+  if (!supported.includes(platform)) {
+    fail(
+      `この OS と CPU（${platform}）の実行ファイルはありません。対応しているのは ${supported.join("、")} です。` +
+        `Bun 1.4.0 以上を入れると、Bun で動かせます: ${releases}`,
+    );
+  }
+  // Linux 向けの実行ファイルは glibc の上で動く。glibc の版が分からなければ、musl（Alpine など）とみなす
+  if (process.platform === "linux" && !process.report.getReport().header.glibcVersionRuntime) {
+    fail(`musl の Linux（Alpine など）では、実行ファイルは動きません。Bun 1.4.0 以上を入れると、Bun で動かせます: ${releases}`);
+  }
+  const pkg = `@itsuki-yamada/accompany-${platform}`;
+  try {
+    return { command: require.resolve(`${pkg}/bin/accompany`), args: [] };
+  } catch {
+    return fail(
+      `${pkg} が入っていません。optionalDependencies を入れない設定（--omit=optional など）を外して入れ直すか、` +
+        "Bun 1.4.0 以上を入れてください",
+    );
+  }
+}
+
+const { command, args } = choose();
+const child = spawn(command, args.concat(process.argv.slice(2)), { stdio: "inherit" });
+
+// 端末の Ctrl+C はプロセスグループ全体に届くので、起動したもの（Bun か実行ファイル）にも直接届く。kill などで起動役だけに
+// 送られたときも伝える（Accompany は、二度目以降の合図を無視する）。起動役は、Accompany が保存して終わるまで待つ
+const signals = ["SIGINT", "SIGTERM", "SIGHUP"];
+for (const signal of signals) {
+  process.on(signal, () => child.kill(signal));
+}
+
+child.on("error", (error) => fail(`${command} を起動できませんでした: ${error.message}`));
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    // 起動したものと同じ合図で終わり、呼び出し元（シェルなど）に合図で終わったことを伝える
+    for (const s of signals) process.removeAllListeners(s);
+    process.kill(process.pid, signal);
+    // 合図を無視する設定を受け継いでいて終わらなかったときは、終了コードで伝える
+    setTimeout(() => process.exit(1), 1000);
+    return;
+  }
+  process.exit(code);
+});