@scalebase/cli 0.0.1 → 1.0.0

package/LICENSE.txt

@@ -0,0 +1,101 @@
+================================================================
+Scalebase CLI ソフトウェア使用許諾契約(EULA)
+================================================================
+
+本ソフトウェア使用許諾契約(以下「本契約」)は、Scalebase株式会社(以下
+「当社」)が提供するコマンドラインツール「Scalebase CLI」およびその関連
+コンポーネント(以下「本ソフトウェア」)の使用条件を、本ソフトウェアを
+利用する個人または法人(以下「利用者」)との間で定めるものです。
+
+本ソフトウェアをインストール、複製、または使用することにより、利用者は
+本契約のすべての条項に同意したものとみなされます。同意しない場合、本
+ソフトウェアを使用することはできません。
+
+----------------------------------------------------------------
+第1条(定義)
+----------------------------------------------------------------
+1. 「Scalebase 契約」とは、利用者(またはその所属組織)と当社との間で
+   締結された、Scalebase サービスに関する利用契約をいう。
+2. 「認可ユーザー」とは、有効な Scalebase 契約に基づき当社が発行した
+   API キーの正当な利用権限を有する者をいう。
+
+----------------------------------------------------------------
+第2条(使用許諾)
+----------------------------------------------------------------
+1. 当社は利用者に対し、本契約の条項に従うことを条件として、本ソフト
+   ウェアを Scalebase 契約の目的の範囲内で使用する、非独占的かつ譲渡
+   不能な権利を許諾する。
+2. 本ソフトウェアの使用は、有効な Scalebase 契約を有する認可ユーザー
+   に限られる。本ソフトウェアは有効な API キーがなければ機能しない。
+
+----------------------------------------------------------------
+第3条(制限事項)
+----------------------------------------------------------------
+利用者は、本ソフトウェアについて次の行為を行ってはならない。
+1. 第三者への再配布、再頒布、貸与、譲渡、またはサブライセンス。
+2. 改変、翻案、二次的著作物の作成。
+3. リバースエンジニアリング、逆コンパイル、逆アセンブル、その他
+   ソースコードまたは内部構造を解析・抽出する行為
+   (法令上明示的に許容される範囲を除く)。
+4. 著作権表示その他の権利表示の削除・改変。
+5. 本ソフトウェアを利用した、当社サービスと競合するツール・サービスの
+   開発。
+
+----------------------------------------------------------------
+第4条(知的財産権)
+----------------------------------------------------------------
+本ソフトウェアに関する著作権その他一切の知的財産権は、当社または当社に
+使用を許諾する者に帰属する。本契約は、第2条に定める使用許諾を除き、
+利用者に何らの権利も移転するものではない。
+
+----------------------------------------------------------------
+第5条(第三者ソフトウェア)
+----------------------------------------------------------------
+本ソフトウェアには、第三者が提供するオープンソースソフトウェアが含まれる
+場合がある。当該第三者ソフトウェアの使用については、それぞれに付属する
+ライセンス条件が適用され、本契約の規定に優先する。第三者ソフトウェアの
+一覧および各ライセンスは、本ソフトウェアに同梱の THIRD-PARTY-NOTICES.txt
+を参照すること。
+
+----------------------------------------------------------------
+第6条(無保証)
+----------------------------------------------------------------
+本ソフトウェアは現状有姿(AS IS)で提供される。当社は、本ソフトウェアの
+正確性、完全性、特定目的への適合性、第三者の権利を侵害しないこと、および
+エラーや中断がないことについて、明示・黙示を問わず一切保証しない。
+
+----------------------------------------------------------------
+第7条(責任の制限)
+----------------------------------------------------------------
+当社は、本ソフトウェアの使用または使用不能から生じる一切の損害
+(逸失利益、データ喪失、事業中断等を含む)について、法令上許容される
+最大限の範囲で責任を負わない。
+
+----------------------------------------------------------------
+第8条(契約期間および終了)
+----------------------------------------------------------------
+1. 本契約に基づく使用許諾は、利用者が本契約を遵守している間、有効に
+   存続する。
+2. 次のいずれかに該当した場合、本ソフトウェアの使用許諾は当然に終了
+   する。
+   (1) 利用者に係る Scalebase 契約が終了したとき。
+   (2) 利用者が本契約のいずれかの条項に違反したとき。
+3. 使用許諾の終了後、利用者は速やかに本ソフトウェアの使用を停止し、
+   保有する複製物を削除・破棄しなければならない。
+
+----------------------------------------------------------------
+第9条(準拠法および管轄)
+----------------------------------------------------------------
+1. 本契約は日本法に準拠し、日本法に従って解釈される。
+2. 本契約に関して生じる一切の紛争については、東京地方裁判所を
+   第一審の専属的合意管轄裁判所とする。
+
+----------------------------------------------------------------
+第10条(既存契約との関係)
+----------------------------------------------------------------
+本契約と既存の Scalebase 利用規約その他の個別契約との間に齟齬がある
+場合、当該 Scalebase 利用規約その他の個別契約が本契約に優先する。
+
+以上
+
+Copyright (c) 2026 Scalebase株式会社. All rights reserved.

package/README.md

@@ -1,5 +1,65 @@
-# @scalebase/cli
+# Scalebase CLI
 
-このパッケージは Scalebase CLI の npm 公開配布に向けた **予約用 placeholder** です。まだ機能しません。
+Scalebase CLI は **Scalebase 契約者向け**のツールです。利用には Scalebase ダッシュボードで発行する **API キー**が必要です。契約・API キーに関するお問い合わせは、担当者または既存のサポート窓口までご連絡ください。
 
-正式版公開までお待ちください。
+Scalebase API を操作するコマンドラインツール兼 MCP サーバーです。請求 (billing) / 顧客 (customer) / 契約 (contract) / 改定 (amendment) / 使用量 (usage) などのデータ取得・作成・更新を行えます。
+
+## インストール
+
+```bash
+npm install -g @scalebase/cli
+```
+
+お使いの OS / CPU に対応するネイティブバイナリ（`optionalDependencies`）が自動的に選択されます。対応プラットフォーム:
+
+| OS      | アーキテクチャ |
+| ------- | -------------- |
+| macOS   | arm64 / amd64  |
+| Linux   | amd64 / arm64  |
+| Windows | amd64          |
+
+Node.js は **18 以上**が必要です。
+
+## 使い方
+
+```bash
+# バージョン確認
+scalebase-cli --version
+
+# API キーを設定して実行
+export SCALEBASE_API_KEY=xxxxxxxx
+scalebase-cli customer list
+```
+
+## MCP サーバーとして使う
+
+`npx` 1 行で MCP サーバーを起動できます。stdio トランスポートを使うため、stdout には MCP プロトコル以外の出力を一切行いません（ログはすべて stderr）。
+
+Claude Code / Claude Desktop などの `.mcp.json`（MCP 設定）例:
+
+```json
+{
+  "mcpServers": {
+    "scalebase": {
+      "command": "npx",
+      "args": ["-y", "@scalebase/cli", "mcp", "serve"],
+      "env": {
+        "SCALEBASE_API_KEY": "xxxxxxxx",
+        "SCALEBASE_ENV": "sandbox"
+      }
+    }
+  }
+}
+```
+
+MCP は既定で `--readonly=true`（read 系ツールのみ）・`--env=sandbox` です。write 系を使う場合は `SCALEBASE_MCP_READONLY=false`、production を使う場合は `SCALEBASE_ENV=production` を明示してください。
+
+## 対応していないプラットフォーム
+
+対応外の OS / CPU では、起動時に明確なエラーメッセージを表示して終了します。また optional dependency のインストールに失敗した場合（`--no-optional` / `--omit=optional` を付けた等）も、再インストール方法を案内して終了します。
+
+## ライセンス
+
+本ソフトウェアの使用には使用許諾契約 (EULA) への同意が必要です。同梱の [`LICENSE.txt`](./LICENSE.txt) を参照してください。
+
+(c) Scalebase株式会社

package/THIRD-PARTY-NOTICES.txt

@@ -0,0 +1,225 @@
+================================================================
+THIRD-PARTY SOFTWARE NOTICES
+Scalebase CLI
+================================================================
+
+本ファイルは Scalebase CLI のバイナリに同梱される第三者オープンソース
+ソフトウェア(OSS)の一覧です。EULA(LICENSE.txt)第5条に基づき、各 OSS の
+利用は下記に示す各ライセンス条件に従います。
+
+各 OSS のライセンス本文(全文)は、それぞれのモジュールのリポジトリ
+(下記 URL)を参照してください。
+
+----------------------------------------------------------------
+生成方法
+----------------------------------------------------------------
+本一覧は go-licenses が現行の Go ツールチェーン(go1.25.12)で動作しな
+かったため(標準ライブラリのパッケージが module info を持たず report が
+中断する)、以下のフォールバック手順で生成しています。
+
+  # バイナリに実際にリンクされる依存モジュールを列挙
+  go list -deps -f '{{if .Module}}{{.Module.Path}} {{.Module.Version}}{{end}}' \
+      ./cmd/scalebase-cli | sort -u
+  # 各モジュールの module cache 内 LICENSE ファイルを読み、種別を判定
+
+ライセンス種別は各モジュール同梱の LICENSE ファイルから判定した推定値
+です。正式なライセンス本文は各リポジトリを参照してください。
+
+収録モジュール数: 32
+内訳: Apache-2.0: 4, BSD-3-Clause: 6, MIT: 22
+Go バージョン: go1.25.12
+
+================================================================
+
+
+Module : github.com/cespare/xxhash/v2
+Version: v2.3.0
+License: MIT
+Source : https://github.com/cespare/xxhash/v2
+----------------------------------------------------------------
+
+Module : github.com/clipperhouse/displaywidth
+Version: v0.10.0
+License: MIT
+Source : https://github.com/clipperhouse/displaywidth
+----------------------------------------------------------------
+
+Module : github.com/clipperhouse/uax29/v2
+Version: v2.6.0
+License: MIT
+Source : https://github.com/clipperhouse/uax29/v2
+----------------------------------------------------------------
+
+Module : github.com/fatih/color
+Version: v1.18.0
+License: MIT
+Source : https://github.com/fatih/color
+----------------------------------------------------------------
+
+Module : github.com/fsnotify/fsnotify
+Version: v1.9.0
+License: BSD-3-Clause
+Source : https://github.com/fsnotify/fsnotify
+----------------------------------------------------------------
+
+Module : github.com/go-viper/mapstructure/v2
+Version: v2.4.0
+License: MIT
+Source : https://github.com/go-viper/mapstructure/v2
+----------------------------------------------------------------
+
+Module : github.com/google/jsonschema-go
+Version: v0.4.3
+License: MIT
+Source : https://github.com/google/jsonschema-go
+----------------------------------------------------------------
+
+Module : github.com/mattn/go-colorable
+Version: v0.1.14
+License: MIT
+Source : https://github.com/mattn/go-colorable
+----------------------------------------------------------------
+
+Module : github.com/mattn/go-isatty
+Version: v0.0.20
+License: MIT
+Source : https://github.com/mattn/go-isatty
+----------------------------------------------------------------
+
+Module : github.com/mattn/go-runewidth
+Version: v0.0.19
+License: MIT
+Source : https://github.com/mattn/go-runewidth
+----------------------------------------------------------------
+
+Module : github.com/modelcontextprotocol/go-sdk
+Version: v1.6.1
+License: Apache-2.0
+Source : https://github.com/modelcontextprotocol/go-sdk
+----------------------------------------------------------------
+
+Module : github.com/olekukonko/cat
+Version: v0.0.0-20250911104152-50322a0618f6
+License: MIT
+Source : https://github.com/olekukonko/cat
+----------------------------------------------------------------
+
+Module : github.com/olekukonko/errors
+Version: v1.2.0
+License: MIT
+Source : https://github.com/olekukonko/errors
+----------------------------------------------------------------
+
+Module : github.com/olekukonko/ll
+Version: v0.1.6
+License: MIT
+Source : https://github.com/olekukonko/ll
+----------------------------------------------------------------
+
+Module : github.com/olekukonko/tablewriter
+Version: v1.1.4
+License: MIT
+Source : https://github.com/olekukonko/tablewriter
+----------------------------------------------------------------
+
+Module : github.com/pelletier/go-toml/v2
+Version: v2.2.4
+License: MIT
+Source : https://github.com/pelletier/go-toml/v2
+----------------------------------------------------------------
+
+Module : github.com/sagikazarmark/locafero
+Version: v0.11.0
+License: MIT
+Source : https://github.com/sagikazarmark/locafero
+----------------------------------------------------------------
+
+Module : github.com/segmentio/asm
+Version: v1.1.3
+License: MIT
+Source : https://github.com/segmentio/asm
+----------------------------------------------------------------
+
+Module : github.com/segmentio/encoding
+Version: v0.5.4
+License: MIT
+Source : https://github.com/segmentio/encoding
+----------------------------------------------------------------
+
+Module : github.com/sourcegraph/conc
+Version: v0.3.1-0.20240121214520-5f936abd7ae8
+License: MIT
+Source : https://github.com/sourcegraph/conc
+----------------------------------------------------------------
+
+Module : github.com/spf13/afero
+Version: v1.15.0
+License: Apache-2.0
+Source : https://github.com/spf13/afero
+----------------------------------------------------------------
+
+Module : github.com/spf13/cast
+Version: v1.10.0
+License: MIT
+Source : https://github.com/spf13/cast
+----------------------------------------------------------------
+
+Module : github.com/spf13/cobra
+Version: v1.10.2
+License: Apache-2.0
+Source : https://github.com/spf13/cobra
+----------------------------------------------------------------
+
+Module : github.com/spf13/pflag
+Version: v1.0.10
+License: BSD-3-Clause
+Source : https://github.com/spf13/pflag
+----------------------------------------------------------------
+
+Module : github.com/spf13/viper
+Version: v1.21.0
+License: MIT
+Source : https://github.com/spf13/viper
+----------------------------------------------------------------
+
+Module : github.com/subosito/gotenv
+Version: v1.6.0
+License: MIT
+Source : https://github.com/subosito/gotenv
+----------------------------------------------------------------
+
+Module : github.com/yosida95/uritemplate/v3
+Version: v3.0.2
+License: BSD-3-Clause
+Source : https://github.com/yosida95/uritemplate/v3
+----------------------------------------------------------------
+
+Module : github.com/zalando/go-keyring
+Version: v0.2.8
+License: MIT
+Source : https://github.com/zalando/go-keyring
+----------------------------------------------------------------
+
+Module : go.yaml.in/yaml/v3
+Version: v3.0.4
+License: Apache-2.0
+Source : https://github.com/yaml/go-yaml
+----------------------------------------------------------------
+
+Module : golang.org/x/oauth2
+Version: v0.35.0
+License: BSD-3-Clause
+Source : https://cs.opensource.google/go/x/oauth2
+----------------------------------------------------------------
+
+Module : golang.org/x/sys
+Version: v0.41.0
+License: BSD-3-Clause
+Source : https://cs.opensource.google/go/x/sys
+----------------------------------------------------------------
+
+Module : golang.org/x/text
+Version: v0.28.0
+License: BSD-3-Clause
+Source : https://cs.opensource.google/go/x/text
+----------------------------------------------------------------

package/bin/scalebase-cli.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+'use strict';
+
+// Thin, dependency-free launcher for the Scalebase CLI.
+//
+// The real program is a native Go binary shipped in a platform-specific
+// optionalDependency (e.g. @scalebase/cli-darwin-arm64). npm installs only the
+// package matching the host's `os`/`cpu`, so at runtime exactly one of them is
+// present. This launcher resolves that binary and execs it, forwarding argv and
+// inheriting stdio verbatim — nothing is written to stdout here, so the MCP
+// stdio transport (`scalebase-cli mcp serve`) is never corrupted.
+//
+// NOTE: `@scalebase` is a build-time placeholder. packaging/npm/build.sh renders
+// this file the same way it renders the package.json templates, substituting
+// the chosen npm scope (default @scalebase; see issue #130). Do not hardcode a
+// literal scope here — keep the single source of truth in build.sh's --scope.
+
+const path = require('path');
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+
+// Maps `${process.platform}-${process.arch}` to the platform package name.
+// Package names use Node's `process.arch` values (`x64`, `arm64`), so the key
+// suffix and the package-name suffix match one-to-one.
+const PACKAGES = {
+  'darwin-arm64': '@scalebase/cli-darwin-arm64',
+  'darwin-x64': '@scalebase/cli-darwin-x64',
+  'linux-x64': '@scalebase/cli-linux-x64',
+  'linux-arm64': '@scalebase/cli-linux-arm64',
+  'win32-x64': '@scalebase/cli-win32-x64',
+};
+
+function fail(lines) {
+  for (const line of lines) {
+    console.error(line);
+  }
+  process.exit(1);
+}
+
+const key = `${process.platform}-${process.arch}`;
+const pkg = PACKAGES[key];
+if (!pkg) {
+  fail([
+    `scalebase-cli: unsupported platform/arch: ${process.platform}/${process.arch}`,
+    `Supported platforms: ${Object.keys(PACKAGES).join(', ')}`,
+    'Scalebase CLI をご利用の環境に対応するバイナリが提供されていません。',
+  ]);
+}
+
+const binaryName = process.platform === 'win32' ? 'scalebase-cli.exe' : 'scalebase-cli';
+
+let pkgDir;
+try {
+  // Resolving package.json always works when the package is installed, and is
+  // unaffected by any `exports` map (a raw binary path can be blocked by one).
+  pkgDir = path.dirname(require.resolve(`${pkg}/package.json`));
+} catch (_e) {
+  fail([
+    `scalebase-cli: platform package "${pkg}" is not installed.`,
+    'これは通常、お使いのプラットフォーム向け optionalDependency の',
+    'インストールに失敗したことを意味します。optional dependencies を',
+    '有効にして再インストールしてください:',
+    '  npm install -g @scalebase/cli   # --no-optional / --omit=optional を付けない',
+  ]);
+}
+
+const binaryPath = path.join(pkgDir, binaryName);
+if (!fs.existsSync(binaryPath)) {
+  fail([
+    `scalebase-cli: binary not found at ${binaryPath}`,
+    `platform package "${pkg}" のインストールが壊れている可能性があります。再インストールしてください。`,
+  ]);
+}
+
+const result = spawnSync(binaryPath, process.argv.slice(2), { stdio: 'inherit' });
+if (result.error) {
+  fail([`scalebase-cli: failed to launch binary: ${result.error.message}`]);
+}
+// status is null exactly when the child was killed by a signal; exit non-zero.
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -1,8 +1,39 @@
 {
   "name": "@scalebase/cli",
-  "version": "0.0.1",
-  "description": "Scalebase CLI — placeholder reserved for upcoming npm distribution. Not yet functional.",
-  "license": "UNLICENSED",
-  "private": false,
-  "keywords": ["scalebase", "cli", "placeholder"]
+  "version": "1.0.0",
+  "description": "Scalebase CLI — Scalebase 契約者向けの CLI / MCP サーバー。利用には Scalebase ダッシュボードで発行する API キーが必要です。",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "homepage": "https://thealp.co.jp",
+  "author": {
+    "name": "Scalebase株式会社",
+    "url": "https://thealp.co.jp"
+  },
+  "keywords": [
+    "scalebase",
+    "cli",
+    "mcp",
+    "billing"
+  ],
+  "bin": {
+    "scalebase-cli": "bin/scalebase-cli.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@scalebase/cli-darwin-arm64": "1.0.0",
+    "@scalebase/cli-darwin-x64": "1.0.0",
+    "@scalebase/cli-linux-x64": "1.0.0",
+    "@scalebase/cli-linux-arm64": "1.0.0",
+    "@scalebase/cli-win32-x64": "1.0.0"
+  },
+  "files": [
+    "bin/scalebase-cli.js",
+    "LICENSE.txt",
+    "THIRD-PARTY-NOTICES.txt",
+    "README.md"
+  ]
 }