@lapius/bin-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lapius7
+
+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

@@ -0,0 +1,92 @@
+# bin — bin.lapius7.com CLIクライアント
+
+[LapBin](https://bin.lapius7.com/)(Lapountでログインできるコード共有サービス)を、ターミナルの`bin`コマンドから使うためのCLI。Go標準ライブラリのみ、依存パッケージなし。
+
+## インストール
+
+npm(Linux / macOS / Windows):
+
+```bash
+npm i -g @lapius/bin-cli
+```
+
+OS/CPUに合ったビルド済みバイナリが入る(Linux/macOSでは初回の起動時にnodeのシムがネイティブバイナリに置き換わり、以後はnodeを経由しない)。更新は同じコマンドで行う。
+
+npmがない場合:
+
+```bash
+curl -fsSL https://bin.lapius7.com/install.sh | bash
+```
+
+Goは不要。OS/CPUに合ったビルド済みバイナリを`~/.local/bin/bin`に置く(`BIN_INSTALL_DIR`で変更可)。Windowsは`https://bin.lapius7.com/cli/bin-windows-amd64.exe`を直接ダウンロードする。
+
+## 使い方
+
+```bash
+bin login                                   # ブラウザでLapountにログイン
+bin login --device                          # SSH先など、手元でブラウザが開けない場合
+bin create main.go util.go -d "説明"         # 作成(既定は限定公開)。URLだけが標準出力に出る
+cat build.log | bin create -f build.log --private
+bin list                                    # 自分のGist(-u <handle> で他人の公開Gist)
+bin view <id>                               # 表示(-f <file> で1ファイルだけ生出力)
+bin edit <id> main.go --remove old.go -t "新しいタイトル" --public
+bin clone <id> [dir]                        # ファイルをダウンロード
+bin fork <id> -t "派生版"                     # コピーして自分の新しいGistを作る(自分のGistも可、公開範囲は元のまま)
+bin delete <id>                             # 削除(確認あり、-yで省略)
+bin star <id> / bin starred               # スター・スターしたGistの一覧
+bin tag <id> python cli                     # タグを設定(bin list --tag python で絞り込み)
+bin run <id>                                # スクリプトを実行(実行前に内容を表示して確認)
+bin version                                 # バージョン表示。配布中の最新版かどうかも確かめる
+```
+
+`<id>`にはGistのURLもそのまま渡せる。
+
+### 手元のフォルダと同期
+
+```bash
+bin clone <id> && cd <id>   # .lapbin.json(取得した時点のリビジョンと各ファイルのSHA-256)も置かれる
+bin status                  # 手元の変更と、Gist側に新しいリビジョンがあるか
+bin pull                    # Gist側の変更を取り込む(両方で変えたファイルがあれば止まる。--forceでGist側を優先)
+bin push -m "メモ"          # 手元のフォルダの内容でGistを更新(Gist側が先に更新されていたら止まる)
+bin sync                    # pull してから、手元の変更があれば push
+```
+
+git でも取得できる(読み取り専用): `git clone https://bin.lapius7.com/<id>.git`。非公開のGistはパスワードにAPIトークン。
+
+### APIトークン(CI・スクリプト用)
+
+```bash
+bin token create ci --expires 90     # 発行(トークンは標準出力にだけ出る。--read で読み取り専用)
+BIN_TOKEN=lbt_… bin list            # bin login の代わりに使う
+bin token list / bin token revoke <id>
+```
+
+トークンで使えるのはLapBinの操作だけ(bin-serverが許可リストで制限し、持ち主として動く短命のJWTに差し替えて中継する)。発行・失効は bin login したセッションからのみ。Webの /settings/tokens でも管理できる。
+
+## 仕組み
+
+- ログインはsca-cliと同じ2方式。`bin login`はローカルにランダムポートの一時HTTPサーバーを立て、`oauth-connect-token`(mint)で`http://127.0.0.1:<port>/callback`向けの使い捨てトークンを発行して`/oauth/v2/authorize?token=...`を開いてもらう。`--device`はdevice code方式(`oauth-device-code`関数)
+- 通信はすべて`https://bin.lapius7.com/api/`(bin-server内のリバースプロキシ)経由。ANON_KEYはプロキシだけが付与するので、このCLIには一切含まれない
+- Gistの読み書きは`bin`スキーマのDB関数(`get_gist`/`list_gists`/`save_gist`/`delete_gist`)を呼ぶだけ。権限チェックはDB側(RLS+SECURITY DEFINER関数)で行われる
+- セッションは`~/.config/bin/session.json`(0600)。アクセストークン失効時は保存済みのrefresh_tokenで自動更新する
+
+## ビルド・配布
+
+```bash
+./build.sh    # 全OS/CPU向けにクロスコンパイルし、web/bin.lapius7.com/server/cli-dist/ へinstall.shと一緒に配置
+```
+
+バージョンは`日付-コミットの短縮ハッシュ`(未コミットの変更があれば`-dirty`付き)。同時に`VERSION`と`build.json`(バージョン・ビルド日時・コミット・各バイナリのSHA-256)も書き出し、https://bin.lapius7.com/cli の「配布中の最新版」はこれを読んで表示する。インストーラーは最後に入ったバイナリの`bin version`を実行して、配布中の版と一致するか照合する。
+
+bin-serverがそのディレクトリを`/install.sh`・`/cli/*`として配信するので、再起動は不要。
+
+npm版は`v*`タグをpushするとGitHub Actions(`.github/workflows/release.yml`)が`npm/build.mjs`でビルドしてnpmに公開し、GitHub Releaseにもバイナリを添付する(npmのTrusted Publisherで認証するのでトークンは不要)。手元での確認は`node npm/build.mjs 0.0.0-dev --pack`。
+npm版は`-X main.channel=npm`付きでビルドされ、`bin version`の最新版確認と更新方法の案内がnpm向けになる。
+
+## 表示言語
+
+日本語・英語・韓国語に対応。`BIN_LANG`(ja / en / ko)、無ければ `LC_ALL`・`LC_MESSAGES`・`LANG` から判断する(未設定・C・POSIXは日本語、それ以外の未対応言語は英語)。インストーラーも同じ規則。
+
+文言は日本語の文字列をそのままキーにして `T("…")` で包み(gettext方式)、英語・韓国語は `cmd/bin/messages.go` に持つ。新しい文言を足したら対応表にも追加すること(無いとその言語でも日本語のまま表示される)。英語の単数形は `Tn()` と `messagesOne`。
+
+開発中のサーバーに向けたい場合は`BIN_SUPABASE_URL`/`BIN_ANON_KEY`/`BIN_SITE_URL`(環境変数または`~/.config/bin/config.env`)で上書きできる。

package/bin/bin

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+// OS/CPU 別パッケージのネイティブバイナリを起動するシム。
+// Linux/macOS では初回の起動時にこのファイル自体をネイティブバイナリで置き換え、次回からは node を経由しない。
+// （npm 11 はインストールスクリプトが既定で動かないため postinstall は使わない）
+'use strict';
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+
+const pkg = `@lapius/bin-cli-${process.platform}-${process.arch}`;
+const exe = 'bin' + (process.platform === 'win32' ? '.exe' : '');
+let bin;
+try {
+  bin = require.resolve(`${pkg}/bin/${exe}`);
+} catch {
+  console.error(`bin: ${pkg} が見つかりません（未対応の環境か、optionalDependencies が省略されました）`);
+  console.error('  npm i -g @lapius/bin-cli で入れ直してください');
+  process.exit(1);
+}
+
+// Windows は npm が node 経由の .cmd を作るので置き換えない
+if (process.platform !== 'win32') {
+  try {
+    const self = fs.realpathSync(__filename);
+    const tmp = `${self}.${process.pid}.tmp`;
+    fs.copyFileSync(bin, tmp);
+    fs.chmodSync(tmp, 0o755);
+    fs.renameSync(tmp, self);
+  } catch {
+    // 書き込めなければシムのまま動く
+  }
+}
+
+const r = spawnSync(bin, process.argv.slice(2), { stdio: 'inherit' });
+if (r.error) {
+  console.error(`bin: ${bin} を起動できません: ${r.error.message}`);
+  process.exit(1);
+}
+if (r.signal) process.kill(process.pid, r.signal);
+process.exit(r.status ?? 1);

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@lapius/bin-cli",
+  "version": "0.1.0",
+  "description": "bin.lapius7.com（LapBin）の CLI クライアント",
+  "keywords": [
+    "cli",
+    "gist",
+    "pastebin",
+    "lapbin"
+  ],
+  "homepage": "https://github.com/Lapius7/bin-cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lapius7/bin-cli.git"
+  },
+  "license": "MIT",
+  "bin": {
+    "bin": "bin/bin"
+  },
+  "files": [
+    "bin/bin"
+  ],
+  "os": [
+    "linux",
+    "darwin",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "optionalDependencies": {
+    "@lapius/bin-cli-linux-x64": "0.1.0",
+    "@lapius/bin-cli-linux-arm64": "0.1.0",
+    "@lapius/bin-cli-darwin-x64": "0.1.0",
+    "@lapius/bin-cli-darwin-arm64": "0.1.0",
+    "@lapius/bin-cli-win32-x64": "0.1.0"
+  }
+}