@chocodrop/setup 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ChocoDrop Project
+
+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,30 @@
+# @chocodrop/setup
+
+Codex、Claude Code、Antigravityを検出し、ChocoDrop MCPを登録するセットアップコマンドです。
+
+```bash
+pnpm dlx @chocodrop/setup@0.1.0-alpha.0
+```
+
+既定では、見つかったツールを表示して確認した後、`~/ChocoDropAssets`を作成し、ユーザー設定へChocoDropを登録します。Antigravityでは既存の`~/.gemini/config/mcp_config.json`を保持し、`mcpServers.chocodrop`だけを追加・更新します。
+
+```bash
+# Codexだけに登録
+pnpm dlx @chocodrop/setup@0.1.0-alpha.0 --client codex --yes
+
+# 素材フォルダを指定
+pnpm dlx @chocodrop/setup@0.1.0-alpha.0 --assets-dir /path/to/assets
+
+# 変更内容だけ確認
+pnpm dlx @chocodrop/setup@0.1.0-alpha.0 --dry-run
+```
+
+pnpmがない環境では`npx --yes @chocodrop/setup@0.1.0-alpha.0`も使用できます。
+
+登録後、CLIを再起動して「ChocoDropの`get_status`でURLを教えて」と依頼してください。
+
+このセットアップは生成サービスを追加しません。普段使っている生成MCPやCLIでPNG、動画、GLBを素材フォルダへ保存し、ChocoDropの`import_asset`で配置します。
+
+案内するパッケージは検証済みバージョンへ固定しています。このパッケージに`install`・`postinstall`スクリプトや外部依存はありません。
+
+[Website](https://nyukicorn.github.io/chocodrop/) · [Source](https://github.com/nyukicorn/chocodrop)

package/bin/chocodrop-setup.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runSetup } from '../src/index.js';
+
+runSetup().catch((error) => {
+  process.stderr.write(`\n設定できませんでした: ${error.message}\n`);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@chocodrop/setup",
+  "version": "0.1.0-alpha.0",
+  "description": "One-command setup for connecting ChocoDrop to Codex, Claude Code, and Antigravity.",
+  "type": "module",
+  "bin": {
+    "chocodrop-setup": "./bin/chocodrop-setup.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "chocodrop",
+    "mcp",
+    "codex",
+    "claude-code",
+    "antigravity"
+  ],
+  "author": {
+    "name": "ChocoDrop Project",
+    "email": "chocodrop.dev@gmail.com"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,265 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir, readFile, rename, stat, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+
+const DEFAULT_MCP_PACKAGE = '@chocodrop/mcp@0.1.0-alpha.0';
+const CLIENT_ORDER = ['codex', 'claude', 'antigravity'];
+const CLIENTS = {
+  codex: { command: 'codex', label: 'Codex' },
+  claude: { command: 'claude', label: 'Claude Code' },
+  antigravity: { command: 'agy', label: 'Antigravity' },
+};
+
+function execute(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    encoding: 'utf8',
+    stdio: options.stdio || 'pipe',
+    env: options.env || process.env,
+  });
+  return {
+    status: result.status ?? 1,
+    stdout: result.stdout || '',
+    stderr: result.stderr || '',
+    error: result.error,
+  };
+}
+
+function expandHome(value) {
+  if (value === '~') return homedir();
+  if (value.startsWith(`~${path.sep}`)) return path.join(homedir(), value.slice(2));
+  return value;
+}
+
+export function parseArgs(argv = process.argv.slice(2)) {
+  const result = { clients: [], yes: false, dryRun: false, help: false };
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index];
+    if (value === '--client') result.clients.push(...String(argv[++index] || '').split(','));
+    else if (value === '--assets-dir') result.assetsDir = argv[++index];
+    else if (value === '--yes' || value === '-y') result.yes = true;
+    else if (value === '--dry-run') result.dryRun = true;
+    else if (value === '--help' || value === '-h') result.help = true;
+    else throw new Error(`不明なオプションです: ${value}`);
+  }
+  result.clients = [...new Set(result.clients.map((value) => value.trim()).filter(Boolean))];
+  return result;
+}
+
+function antigravityLocations(home = homedir(), platform = process.platform) {
+  if (platform === 'darwin')
+    return ['/Applications/Antigravity.app', path.join(home, 'Applications/Antigravity.app')];
+  if (platform === 'win32') {
+    const localAppData = process.env.LOCALAPPDATA;
+    return localAppData ? [path.join(localAppData, 'Programs', 'Antigravity', 'Antigravity.exe')] : [];
+  }
+  return ['/usr/bin/antigravity', '/usr/local/bin/antigravity'];
+}
+
+export function detectClients(run = execute, fileExists = existsSync) {
+  return CLIENT_ORDER.filter((name) => {
+    if (run(CLIENTS[name].command, ['--version']).status === 0) return true;
+    return name === 'antigravity' && antigravityLocations().some((candidate) => fileExists(candidate));
+  });
+}
+
+function packageCommand(packageSpec, assetsDir, runner = 'pnpm') {
+  if (runner === 'pnpm') return ['pnpm', 'dlx', packageSpec, '--assets-dir', assetsDir];
+  return ['npx', '-y', packageSpec, '--assets-dir', assetsDir];
+}
+
+export function registration(
+  name,
+  assetsDir,
+  packageSpec = DEFAULT_MCP_PACKAGE,
+  runner = 'pnpm',
+  home = homedir()
+) {
+  const mcpCommand = packageCommand(packageSpec, assetsDir, runner);
+  if (name === 'codex') {
+    return {
+      name,
+      ...CLIENTS[name],
+      add: ['mcp', 'add', 'chocodrop', '--', ...mcpCommand],
+      get: ['mcp', 'get', 'chocodrop'],
+      remove: ['mcp', 'remove', 'chocodrop'],
+    };
+  }
+  if (name === 'claude') {
+    return {
+      name,
+      ...CLIENTS[name],
+      add: ['mcp', 'add', '--transport', 'stdio', '--scope', 'user', 'chocodrop', '--', ...mcpCommand],
+      get: ['mcp', 'get', 'chocodrop'],
+      remove: ['mcp', 'remove', '--scope', 'user', 'chocodrop'],
+    };
+  }
+  if (name === 'antigravity') {
+    return {
+      name,
+      ...CLIENTS[name],
+      kind: 'json',
+      configPath: path.join(home, '.gemini', 'config', 'mcp_config.json'),
+      server: { command: mcpCommand[0], args: mcpCommand.slice(1) },
+    };
+  }
+  throw new Error(`対応していないツールです: ${name}`);
+}
+
+export function shellCommand(command, args) {
+  const quote = (value) => (/^[A-Za-z0-9_./:@%+=,-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`);
+  return [command, ...args].map(quote).join(' ');
+}
+
+function readJsonConfig(configPath) {
+  try {
+    const source = readFileSync(configPath, 'utf8').trim();
+    if (!source) return {};
+    const value = JSON.parse(source);
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+      throw new Error('設定のルートがJSONオブジェクトではありません');
+    return value;
+  } catch (error) {
+    if (error.code === 'ENOENT') return {};
+    throw new Error(`Antigravity設定を読み込めません: ${error.message}`);
+  }
+}
+
+function configured(item, run, loadConfig = readJsonConfig) {
+  if (item.kind === 'json') return Boolean(loadConfig(item.configPath).mcpServers?.chocodrop);
+  const result = run(item.command, item.get);
+  return result.status === 0;
+}
+
+async function updateAntigravityConfig(item) {
+  await mkdir(path.dirname(item.configPath), { recursive: true });
+  let config = {};
+  let mode = 0o600;
+  try {
+    const source = (await readFile(item.configPath, 'utf8')).trim();
+    config = source ? JSON.parse(source) : {};
+    mode = (await stat(item.configPath)).mode & 0o777;
+  } catch (error) {
+    if (error.code !== 'ENOENT') throw new Error(`Antigravity設定を更新できません: ${error.message}`);
+  }
+  if (!config || typeof config !== 'object' || Array.isArray(config))
+    throw new Error('Antigravity設定のルートがJSONオブジェクトではありません');
+  if (!config.mcpServers || typeof config.mcpServers !== 'object' || Array.isArray(config.mcpServers))
+    config.mcpServers = {};
+  config.mcpServers.chocodrop = item.server;
+  const temporary = `${item.configPath}.${process.pid}.tmp`;
+  await writeFile(temporary, `${JSON.stringify(config, null, 2)}\n`, { mode });
+  await rename(temporary, item.configPath);
+}
+
+export async function applySetup(
+  plan,
+  { run = execute, makeDirectory = mkdir, updateConfig = updateAntigravityConfig } = {}
+) {
+  await makeDirectory(plan.assetsDir, { recursive: true });
+  const completed = [];
+  for (const item of plan.items) {
+    if (item.kind === 'json') {
+      await updateConfig(item);
+      completed.push(item.name);
+      continue;
+    }
+    if (configured(item, run)) {
+      const removed = run(item.command, item.remove);
+      if (removed.status !== 0)
+        throw new Error(`${item.label}の既存ChocoDrop設定を置き換えられませんでした`);
+    }
+    const added = run(item.command, item.add);
+    if (added.status !== 0) {
+      const details = (added.stderr || added.stdout).trim();
+      throw new Error(`${item.label}へ登録できませんでした${details ? `: ${details}` : ''}`);
+    }
+    completed.push(item.name);
+  }
+  return completed;
+}
+
+function usage() {
+  return `🍫 ChocoDrop setup\n\n使い方:\n  pnpm dlx @chocodrop/setup@0.1.0-alpha.0\n  pnpm dlx @chocodrop/setup@0.1.0-alpha.0 --client codex,antigravity --yes\n\nオプション:\n  --client <name>      codex / claude / antigravity / all（カンマ区切り可）\n  --assets-dir <path>  素材フォルダ（既定: ~/ChocoDropAssets）\n  --yes, -y            確認を省略\n  --dry-run            変更せず、実行内容だけ表示\n`;
+}
+
+async function confirm(message, input, output) {
+  const prompt = createInterface({ input, output });
+  try {
+    const answer = (await prompt.question(`${message} [Y/n] `)).trim().toLowerCase();
+    return answer === '' || answer === 'y' || answer === 'yes';
+  } finally {
+    prompt.close();
+  }
+}
+
+export async function runSetup(
+  argv = process.argv.slice(2),
+  {
+    run = execute,
+    makeDirectory = mkdir,
+    fileExists = existsSync,
+    loadConfig = readJsonConfig,
+    updateConfig = updateAntigravityConfig,
+    input = process.stdin,
+    output = process.stdout,
+    errorOutput = process.stderr,
+  } = {}
+) {
+  const args = parseArgs(argv);
+  if (args.help) {
+    output.write(usage());
+    return { changed: false, clients: [] };
+  }
+
+  const detected = detectClients(run, fileExists);
+  let selected = args.clients.length ? args.clients : detected;
+  if (selected.includes('all')) selected = detected;
+  const invalid = selected.filter((name) => !CLIENTS[name]);
+  if (invalid.length) throw new Error(`対応していないツールです: ${invalid.join(', ')}`);
+  const missing = selected.filter((name) => !detected.includes(name));
+  if (missing.length)
+    throw new Error(`ツールが見つかりません: ${missing.map((name) => CLIENTS[name].label).join(', ')}`);
+  if (!selected.length)
+    throw new Error('Codex、Claude Code、Antigravityが見つかりません。先に利用するツールをインストールしてください');
+
+  const assetsDir = path.resolve(expandHome(args.assetsDir || path.join(homedir(), 'ChocoDropAssets')));
+  const runner = run('pnpm', ['--version']).status === 0 ? 'pnpm' : 'npx';
+  const plan = { assetsDir, items: selected.map((name) => registration(name, assetsDir, DEFAULT_MCP_PACKAGE, runner)) };
+  output.write('\n🍫 ChocoDropを設定します\n');
+  output.write(`素材フォルダ: ${assetsDir}\n`);
+  output.write(`接続先: ${plan.items.map((item) => item.label).join('・')}\n\n`);
+  for (const item of plan.items) {
+    if (item.kind === 'json')
+      output.write(`  ${item.configPath} の mcpServers.chocodrop を設定\n`);
+    else output.write(`  ${shellCommand(item.command, item.add)}\n`);
+  }
+  const replacements = plan.items.filter((item) => configured(item, run, loadConfig));
+  if (replacements.length)
+    output.write(`\n既存のChocoDrop設定を置き換えます: ${replacements.map((item) => item.label).join('・')}\n`);
+
+  if (args.dryRun) {
+    output.write('\nドライランのため変更していません。\n');
+    return { changed: false, clients: selected, assetsDir };
+  }
+  if (!args.yes) {
+    if (!input.isTTY)
+      throw new Error('非対話環境では--yesを付けて実行してください');
+    if (!(await confirm('\n素材フォルダを作成し、上記の設定を登録しますか？', input, output))) {
+      output.write('変更しませんでした。\n');
+      return { changed: false, clients: selected, assetsDir };
+    }
+  }
+
+  const completed = await applySetup(plan, { run, makeDirectory, updateConfig });
+  output.write('\n✅ ChocoDrop MCPを登録しました。\n');
+  output.write('ツールを再起動し、「ChocoDropのget_statusでURLを教えて」と依頼してください。\n');
+  output.write('生成した素材は上記フォルダへ保存し、import_assetで配置できます。\n');
+  if (completed.length !== selected.length)
+    errorOutput.write('一部のCLIを登録できませんでした。\n');
+  return { changed: true, clients: completed, assetsDir };
+}
+
+export { CLIENTS, DEFAULT_MCP_PACKAGE, usage };