setup-cc-room 0.2.0

package/dist/chunk-UWFC4FU6.js

@@ -0,0 +1,129 @@
+import {
+  resolveCcRoomDir
+} from "./chunk-WCEABGOA.js";
+
+// src/register-service.ts
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir, platform } from "os";
+import { execFileSync } from "child_process";
+var CC_ROOM_DIR = resolveCcRoomDir();
+function getDaemonBinPath() {
+  try {
+    const which = execFileSync("which", ["cc-room-daemon"], { encoding: "utf-8", stdio: "pipe" }).trim();
+    if (which) return which;
+  } catch {
+  }
+  return join(CC_ROOM_DIR, "bin", "cc-room-daemon");
+}
+function ccRoomHomeEnvXml() {
+  if (!process.env.CC_ROOM_HOME) return "";
+  return `
+    <key>CC_ROOM_HOME</key>
+    <string>${process.env.CC_ROOM_HOME}</string>`;
+}
+function registerLaunchd() {
+  const plistDir = join(homedir(), "Library", "LaunchAgents");
+  const plistPath = join(plistDir, "dev.ccroom.daemon.plist");
+  const daemonBin = getDaemonBinPath();
+  const logPath = join(CC_ROOM_DIR, "logs", "daemon.log");
+  mkdirSync(join(CC_ROOM_DIR, "logs"), { recursive: true });
+  mkdirSync(plistDir, { recursive: true });
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>dev.ccroom.daemon</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${daemonBin}</string>
+  </array>
+  <key>KeepAlive</key>
+  <true/>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${logPath}</string>
+  <key>StandardErrorPath</key>
+  <string>${logPath}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>${ccRoomHomeEnvXml()}
+  </dict>
+</dict>
+</plist>
+`;
+  writeFileSync(plistPath, plist, { mode: 420 });
+  try {
+    execFileSync("launchctl", ["unload", plistPath], { stdio: "pipe" });
+  } catch {
+  }
+  try {
+    execFileSync("launchctl", ["load", plistPath], { stdio: "pipe" });
+    console.log(`         launchd \u306B\u767B\u9332\u3057\u307E\u3057\u305F: ${plistPath}`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(`  \x1B[33m\u26A0 launchd \u767B\u9332\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${msg}\x1B[0m`);
+    console.log(`    \u624B\u52D5\u3067\u767B\u9332: launchctl load ${plistPath}`);
+  }
+}
+function registerSystemd() {
+  const serviceDir = join(homedir(), ".config", "systemd", "user");
+  const servicePath = join(serviceDir, "cc-room-daemon.service");
+  const daemonBin = getDaemonBinPath();
+  const logPath = join(CC_ROOM_DIR, "logs", "daemon.log");
+  mkdirSync(join(CC_ROOM_DIR, "logs"), { recursive: true });
+  mkdirSync(serviceDir, { recursive: true });
+  const envLine = process.env.CC_ROOM_HOME ? `Environment=CC_ROOM_HOME=${process.env.CC_ROOM_HOME}
+` : "";
+  const unit = `[Unit]
+Description=cc-room daemon
+After=network.target
+
+[Service]
+ExecStart=${daemonBin}
+Restart=on-failure
+RestartSec=5
+${envLine}StandardOutput=append:${logPath}
+StandardError=append:${logPath}
+
+[Install]
+WantedBy=default.target
+`;
+  writeFileSync(servicePath, unit, { mode: 420 });
+  try {
+    execFileSync("systemctl", ["--user", "daemon-reload"], { stdio: "pipe" });
+    execFileSync("systemctl", ["--user", "enable", "--now", "cc-room-daemon"], { stdio: "pipe" });
+    console.log(`         systemd \u306B\u767B\u9332\u3057\u307E\u3057\u305F: ${servicePath}`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(`  \x1B[33m\u26A0 systemd \u767B\u9332\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${msg}\x1B[0m`);
+    console.log(`    \u624B\u52D5\u3067\u767B\u9332: systemctl --user enable --now cc-room-daemon`);
+  }
+}
+async function registerService() {
+  const os = platform();
+  if (os === "darwin") {
+    registerLaunchd();
+  } else if (os === "linux") {
+    registerSystemd();
+  } else {
+    console.log(`  \x1B[33m\u26A0 ${os} \u3067\u306E\u81EA\u52D5\u8D77\u52D5\u767B\u9332\u306F\u30B5\u30DD\u30FC\u30C8\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002\u624B\u52D5\u3067 cc-room-daemon \u3092\u8D77\u52D5\u3057\u3066\u304F\u3060\u3055\u3044\u3002\x1B[0m`);
+  }
+  const pidPath = join(CC_ROOM_DIR, "daemon.pid");
+  if (!existsSync(pidPath)) {
+    console.log("         daemon \u306E\u8D77\u52D5\u3092\u5F85\u6A5F\u4E2D...");
+    await new Promise((resolve) => setTimeout(resolve, 2e3));
+  }
+  if (existsSync(pidPath)) {
+    console.log("         daemon \u304C\u8D77\u52D5\u3057\u307E\u3057\u305F");
+  } else {
+    console.log("  \x1B[33m\u26A0 daemon \u306E\u81EA\u52D5\u8D77\u52D5\u78BA\u8A8D\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\u3002\u624B\u52D5\u3067 cc-room-daemon \u3092\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002\x1B[0m");
+  }
+}
+
+export {
+  registerService
+};

package/dist/chunk-WCEABGOA.js

@@ -0,0 +1,10 @@
+// src/paths.ts
+import { join } from "path";
+import { homedir } from "os";
+function resolveCcRoomDir(env = process.env) {
+  return env.CC_ROOM_HOME || join(homedir(), ".cc-room");
+}
+
+export {
+  resolveCcRoomDir
+};

package/dist/chunk-XFCYRKG6.js

@@ -0,0 +1,117 @@
+// src/register-service.ts
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir, platform } from "os";
+import { execFileSync } from "child_process";
+var CC_ROOM_DIR = join(homedir(), ".cc-room");
+function getDaemonBinPath() {
+  try {
+    const which = execFileSync("which", ["cc-room-daemon"], { encoding: "utf-8", stdio: "pipe" }).trim();
+    if (which) return which;
+  } catch {
+  }
+  return join(CC_ROOM_DIR, "bin", "cc-room-daemon");
+}
+function registerLaunchd() {
+  const plistDir = join(homedir(), "Library", "LaunchAgents");
+  const plistPath = join(plistDir, "dev.ccroom.daemon.plist");
+  const daemonBin = getDaemonBinPath();
+  const logPath = join(CC_ROOM_DIR, "logs", "daemon.log");
+  mkdirSync(join(CC_ROOM_DIR, "logs"), { recursive: true });
+  mkdirSync(plistDir, { recursive: true });
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>dev.ccroom.daemon</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${daemonBin}</string>
+  </array>
+  <key>KeepAlive</key>
+  <true/>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${logPath}</string>
+  <key>StandardErrorPath</key>
+  <string>${logPath}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>
+  </dict>
+</dict>
+</plist>
+`;
+  writeFileSync(plistPath, plist, { mode: 420 });
+  try {
+    execFileSync("launchctl", ["unload", plistPath], { stdio: "pipe" });
+  } catch {
+  }
+  try {
+    execFileSync("launchctl", ["load", plistPath], { stdio: "pipe" });
+    console.log(`         launchd \u306B\u767B\u9332\u3057\u307E\u3057\u305F: ${plistPath}`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(`  \x1B[33m\u26A0 launchd \u767B\u9332\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${msg}\x1B[0m`);
+    console.log(`    \u624B\u52D5\u3067\u767B\u9332: launchctl load ${plistPath}`);
+  }
+}
+function registerSystemd() {
+  const serviceDir = join(homedir(), ".config", "systemd", "user");
+  const servicePath = join(serviceDir, "cc-room-daemon.service");
+  const daemonBin = getDaemonBinPath();
+  const logPath = join(CC_ROOM_DIR, "logs", "daemon.log");
+  mkdirSync(join(CC_ROOM_DIR, "logs"), { recursive: true });
+  mkdirSync(serviceDir, { recursive: true });
+  const unit = `[Unit]
+Description=cc-room daemon
+After=network.target
+
+[Service]
+ExecStart=${daemonBin}
+Restart=on-failure
+RestartSec=5
+StandardOutput=append:${logPath}
+StandardError=append:${logPath}
+
+[Install]
+WantedBy=default.target
+`;
+  writeFileSync(servicePath, unit, { mode: 420 });
+  try {
+    execFileSync("systemctl", ["--user", "daemon-reload"], { stdio: "pipe" });
+    execFileSync("systemctl", ["--user", "enable", "--now", "cc-room-daemon"], { stdio: "pipe" });
+    console.log(`         systemd \u306B\u767B\u9332\u3057\u307E\u3057\u305F: ${servicePath}`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(`  \x1B[33m\u26A0 systemd \u767B\u9332\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${msg}\x1B[0m`);
+    console.log(`    \u624B\u52D5\u3067\u767B\u9332: systemctl --user enable --now cc-room-daemon`);
+  }
+}
+async function registerService() {
+  const os = platform();
+  if (os === "darwin") {
+    registerLaunchd();
+  } else if (os === "linux") {
+    registerSystemd();
+  } else {
+    console.log(`  \x1B[33m\u26A0 ${os} \u3067\u306E\u81EA\u52D5\u8D77\u52D5\u767B\u9332\u306F\u30B5\u30DD\u30FC\u30C8\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002\u624B\u52D5\u3067 cc-room-daemon \u3092\u8D77\u52D5\u3057\u3066\u304F\u3060\u3055\u3044\u3002\x1B[0m`);
+  }
+  const pidPath = join(CC_ROOM_DIR, "daemon.pid");
+  if (!existsSync(pidPath)) {
+    console.log("         daemon \u306E\u8D77\u52D5\u3092\u5F85\u6A5F\u4E2D...");
+    await new Promise((resolve) => setTimeout(resolve, 2e3));
+  }
+  if (existsSync(pidPath)) {
+    console.log("         daemon \u304C\u8D77\u52D5\u3057\u307E\u3057\u305F");
+  } else {
+    console.log("  \x1B[33m\u26A0 daemon \u306E\u81EA\u52D5\u8D77\u52D5\u78BA\u8A8D\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\u3002\u624B\u52D5\u3067 cc-room-daemon \u3092\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002\x1B[0m");
+  }
+}
+
+export {
+  registerService
+};

package/dist/daemon-resolver.d.ts

@@ -0,0 +1,8 @@
+/**
+ * setup パッケージ基準で cc-room-daemon 本体のパスを探す。
+ * 優先: vendor 同梱（npm / pack:vendor）→ ローカル dist-bundle
+ */
+declare function resolveDaemonSource(setupPackageRoot: string): string | null;
+declare const DAEMON_MISSING_HINT = "cc-room-daemon \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u30EA\u30DD\u30B8\u30C8\u30EA\u3067\u306F `pnpm --filter setup-cc-room run pack:vendor` \u3092\u5B9F\u884C\u3059\u308B\u304B\u3001npm \u306E setup-cc-room \u30D1\u30C3\u30B1\u30FC\u30B8\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002";
+
+export { DAEMON_MISSING_HINT, resolveDaemonSource };

package/dist/daemon-resolver.js

@@ -0,0 +1,8 @@
+import {
+  DAEMON_MISSING_HINT,
+  resolveDaemonSource
+} from "./chunk-R5BAC4BK.js";
+export {
+  DAEMON_MISSING_HINT,
+  resolveDaemonSource
+};

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import {
+  install
+} from "./chunk-QOXK3LB2.js";
+import "./chunk-R5BAC4BK.js";
+import "./chunk-UWFC4FU6.js";
+import "./chunk-WCEABGOA.js";
+import "./chunk-5NTML4PF.js";
+import {
+  printResults,
+  validateAll
+} from "./chunk-NJES6PZ3.js";
+
+// src/index.ts
+async function main() {
+  console.log("\n  \u{1F3E0} setup-cc-room v0.2.0\n");
+  console.log("  Preflight checks \u3092\u5B9F\u884C\u4E2D...");
+  const { passed, results } = validateAll();
+  printResults(results);
+  if (!passed) {
+    console.log("  \x1B[31m\u524D\u63D0\u6761\u4EF6\u3092\u6E80\u305F\u3057\u3066\u3044\u307E\u305B\u3093\u3002\u4E0A\u8A18\u306E\u554F\u984C\u3092\u89E3\u6C7A\u3057\u3066\u304B\u3089\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002\x1B[0m\n");
+    process.exit(1);
+  }
+  console.log("  \x1B[32m\u5168\u30C1\u30A7\u30C3\u30AF\u901A\u904E\u3002\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u3092\u958B\u59CB\u3057\u307E\u3059\u3002\x1B[0m\n");
+  await install();
+  console.log(`
+  \x1B[32m\u2705 \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u304C\u5B8C\u4E86\u3057\u307E\u3057\u305F\uFF01\x1B[0m
+
+  cc-room \u306E\u4F7F\u3044\u65B9:
+
+  \u3010\u4F1A\u8B70\u5BA4\u3092\u958B\u304F\u5834\u5408\u3011
+    1. Claude Code \u3092\u518D\u8D77\u52D5\uFF08MCP \u3068 Hooks \u3092\u6709\u52B9\u5316\uFF09
+    2. /room open <name>  \u2190 \u4F1A\u8B70\u5BA4\u3092\u958B\u304F\uFF08PIN \u767A\u884C\uFF09
+    3. \u8868\u793A\u3055\u308C\u308B\u90E8\u5C4B\u540D\u3068 PIN \u3092\u76F8\u624B\u306B\u53E3\u982D\u3084 DM \u3067\u4F1D\u3048\u308B
+    4. \u76F8\u624B\u304C /room join <name> <PIN> \u3092\u5B9F\u884C\u3059\u308C\u3070\u53C2\u52A0\u5B8C\u4E86
+
+  \u3010\u62DB\u5F85\u3055\u308C\u305F\u5834\u5408\u3011
+    1. Claude Code \u3092\u518D\u8D77\u52D5
+    2. /room join <name> <PIN>  \u2190 \u76F8\u624B\u304B\u3089\u53D7\u3051\u53D6\u3063\u305F\u5024\u3092\u5165\u529B
+
+  \u3010\u65E5\u5E38\u64CD\u4F5C\u3011
+    /room             \u2026 \u30DB\u30EF\u30A4\u30C8\u30DC\u30FC\u30C9\u3092\u898B\u308B
+    /private          \u2026 \u72B6\u614B\u8868\u793A\u3001\u624B\u5143/\u516C\u958B\u306E\u5207\u66FF\uFF08on|off|share|drop\uFF09
+
+  \u26A0\uFE0F  cc-room \u306F\u81EA\u52D5\u3067\u76F8\u624B\u306B\u901A\u77E5\u3057\u307E\u305B\u3093\u3002
+      \u90E8\u5C4B\u540D\u3068 PIN \u306F\u81EA\u5206\u3067\u76F8\u624B\u306B\u4F1D\u3048\u3066\u304F\u3060\u3055\u3044\u3002
+
+  \u63A5\u7D9A\u5F8C\u306F\u540C\u3058 WiFi\uFF08LAN\uFF09\u5185\u306B\u3044\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002
+  \uFF08VPN \u3067\u540C\u4E00 LAN \u76F8\u5F53\u306B\u306A\u308C\u3070\u30EA\u30E2\u30FC\u30C8\u3067\u3082\u4F7F\u3048\u307E\u3059\uFF09
+
+  \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8: https://github.com/takanorisuzuki/cc-room
+`);
+}
+main().catch((err) => {
+  console.error("  \x1B[31m\u30A8\u30E9\u30FC:\x1B[0m", err instanceof Error ? err.message : err);
+  process.exit(1);
+});

package/dist/installer.d.ts

@@ -0,0 +1,3 @@
+declare function install(): Promise<void>;
+
+export { install };

package/dist/installer.js

@@ -0,0 +1,10 @@
+import {
+  install
+} from "./chunk-QOXK3LB2.js";
+import "./chunk-R5BAC4BK.js";
+import "./chunk-UWFC4FU6.js";
+import "./chunk-WCEABGOA.js";
+import "./chunk-5NTML4PF.js";
+export {
+  install
+};

package/dist/paths.d.ts

@@ -0,0 +1,4 @@
+/** daemon と同じく CC_ROOM_HOME を尊重する */
+declare function resolveCcRoomDir(env?: NodeJS.ProcessEnv): string;
+
+export { resolveCcRoomDir };

package/dist/paths.js

@@ -0,0 +1,6 @@
+import {
+  resolveCcRoomDir
+} from "./chunk-WCEABGOA.js";
+export {
+  resolveCcRoomDir
+};

package/dist/register-service.d.ts

@@ -0,0 +1,3 @@
+declare function registerService(): Promise<void>;
+
+export { registerService };

package/dist/register-service.js

@@ -0,0 +1,7 @@
+import {
+  registerService
+} from "./chunk-UWFC4FU6.js";
+import "./chunk-WCEABGOA.js";
+export {
+  registerService
+};

package/dist/settings-merger.d.ts

@@ -0,0 +1,3 @@
+declare function mergeSettings(): void;
+
+export { mergeSettings };

package/dist/settings-merger.js

@@ -0,0 +1,6 @@
+import {
+  mergeSettings
+} from "./chunk-5NTML4PF.js";
+export {
+  mergeSettings
+};

package/dist/validators.d.ts

@@ -0,0 +1,12 @@
+interface ValidationResult {
+    ok: boolean;
+    message: string;
+    hint?: string;
+}
+declare function validateAll(): {
+    passed: boolean;
+    results: ValidationResult[];
+};
+declare function printResults(results: ValidationResult[]): void;
+
+export { printResults, validateAll };

package/dist/validators.js

@@ -0,0 +1,8 @@
+import {
+  printResults,
+  validateAll
+} from "./chunk-NJES6PZ3.js";
+export {
+  printResults,
+  validateAll
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "setup-cc-room",
+  "version": "0.2.0",
+  "description": "Install cc-room — bring your Claude Code into a shared LAN meeting room",
+  "license": "MIT",
+  "author": "Takanori Suzuki",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/takanorisuzuki/cc-room.git",
+    "directory": "packages/setup"
+  },
+  "type": "module",
+  "bin": {
+    "setup-cc-room": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "vendor"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/installer.ts src/settings-merger.ts src/register-service.ts src/validators.ts src/daemon-resolver.ts src/paths.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "pack:vendor": "node scripts/pack-vendor.mjs",
+    "prepack": "pnpm run build && pnpm run pack:vendor",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist vendor"
+  },
+  "dependencies": {
+    "yaml": "^2.4.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "tsup": "^8.1.0"
+  }
+}

package/vendor/commands/room/private.md

@@ -0,0 +1,75 @@
+---
+name: private
+description: 手元モードの ON/OFF を切り替える。OFF に戻すときは溜まった作業を share（送る）/ drop（捨てる）から毎回選択する。
+---
+
+手元（Private）/ 公開を切り替えるコマンド。公開中（Private OFF）は Primary ルームへサマリー・成果物が自動で流れる。Private ON 中の執筆は pending に蓄積され、誰にも見えない。
+
+## ポートの取得
+
+すべての HTTP リクエスト前に、以下でポートを取得する:
+
+```bash
+CC_ROOM_HOME="${CC_ROOM_HOME:-$HOME/.cc-room}"
+HTTP_PORT=$(grep 'http_port:' "$CC_ROOM_HOME/config.yaml" 2>/dev/null | awk '{print $2}' | tr -d '[:space:]')
+HTTP_PORT="${HTTP_PORT:-7332}"
+BASE_URL="http://127.0.0.1:$HTTP_PORT"
+```
+
+## サブコマンド
+
+### `/private`（引数なし）— 状態表示
+
+1. `GET $BASE_URL/status` を取得する。
+2. 以下の形式で表示する:
+   ```
+   🔒 Private ON（手元モード） / 📡 公開中（Private OFF）
+   Primary: <primary_room_name>
+   手元に溜まっている作業: <pending_turns + pending_files> 件
+   ```
+
+### `/private on` — 手元モードへ
+
+1. `POST $BASE_URL/private` に `{ "mode": "on" }` を送信する。
+2. 成功した場合:
+   ```
+   🔒 手元モードにしました。作業は誰にも見えません（/private off で公開に戻す）
+   ```
+
+### `/private off` — 公開へ戻る
+
+1. `POST $BASE_URL/private` に `{ "mode": "off" }` を送信する。
+2. レスポンスで分岐する:
+   - `needs_choice: true` の場合、**必ずユーザーに確認する**（自動で share しない）:
+     ```
+     手元に <pending> 件あります。Primary（<primary_room_name>）へ送りますか？
+     → share（送ってから公開に戻る） / drop（捨てて公開に戻る）
+     ```
+     ユーザーの選択に応じて `/private share` または `/private drop` を実行する。
+   - `needs_choice` がない場合（pending 0 件）:
+     ```
+     📡 公開に戻りました。作業サマリーが Primary（<primary_room_name>）に流れます
+     ```
+
+### `/private share` — pending を送ってから公開へ
+
+1. `POST $BASE_URL/private` に `{ "mode": "share" }` を送信する。
+2. 成功した場合:
+   ```
+   📡 手元の <shared> 件を Primary（<primary_room_name>）へ共有して公開に戻りました
+   ```
+
+### `/private drop` — pending を捨てて公開へ
+
+1. `POST $BASE_URL/private` に `{ "mode": "drop" }` を送信する。
+2. 成功した場合:
+   ```
+   🗑 手元の <dropped> 件を破棄して公開に戻りました
+   ```
+
+## エラー処理
+
+- daemon が起動していない場合:
+  「cc-room daemon が起動していません。」
+- ルームに参加していない場合:
+  「ルームに参加していません。`/room open` または `/room join` で参加してください。」