@jcjeon/integration-cli 0.2.0

package/apps/web/src/lib/toast.tsx

@@ -0,0 +1,175 @@
+"use client";
+
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useRef,
+  useState,
+} from "react";
+import { createPortal } from "react-dom";
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+export type ToastType = "success" | "error" | "info";
+
+export interface ToastItem {
+  id: string;
+  type: ToastType;
+  title: string;
+  message?: string;
+}
+
+interface ToastCtx {
+  addToast: (toast: Omit<ToastItem, "id">) => void;
+  removeToast: (id: string) => void;
+}
+
+const AUTO_DISMISS_MS = 4500;
+
+// ─── Context ──────────────────────────────────────────────────────────────────
+
+const ToastContext = createContext<ToastCtx | null>(null);
+
+export function useToast() {
+  const ctx = useContext(ToastContext);
+  if (!ctx) throw new Error("useToast must be used within ToastProvider");
+  return ctx;
+}
+
+// ─── Single Toast Item ────────────────────────────────────────────────────────
+
+const TYPE_STYLES: Record<
+  ToastType,
+  { wrap: string; iconColor: string; icon: React.ReactNode }
+> = {
+  success: {
+    wrap: "border-emerald-500/30 bg-emerald-500/[0.08] text-emerald-800 dark:text-emerald-200",
+    iconColor: "text-emerald-500",
+    icon: (
+      <svg viewBox="0 0 16 16" fill="currentColor" className="h-4 w-4">
+        <path
+          fillRule="evenodd"
+          d="M12.416 3.376a.75.75 0 01.208 1.04l-5 7.5a.75.75 0 01-1.154.114l-3-3a.75.75 0 011.06-1.06l2.353 2.353 4.493-6.74a.75.75 0 011.04-.207z"
+          clipRule="evenodd"
+        />
+      </svg>
+    ),
+  },
+  error: {
+    wrap: "border-red-500/30 bg-red-500/[0.08] text-red-800 dark:text-red-200",
+    iconColor: "text-red-500",
+    icon: (
+      <svg viewBox="0 0 16 16" fill="currentColor" className="h-4 w-4">
+        <path
+          fillRule="evenodd"
+          d="M8 1a7 7 0 100 14A7 7 0 008 1zM6.47 6.47a.75.75 0 011.06 0L8 6.94l.47-.47a.75.75 0 111.06 1.06L9.06 8l.47.47a.75.75 0 11-1.06 1.06L8 9.06l-.47.47a.75.75 0 01-1.06-1.06L6.94 8l-.47-.47a.75.75 0 010-1.06z"
+          clipRule="evenodd"
+        />
+      </svg>
+    ),
+  },
+  info: {
+    wrap: "border-blue-500/30 bg-blue-500/[0.08] text-blue-800 dark:text-blue-200",
+    iconColor: "text-blue-500",
+    icon: (
+      <svg viewBox="0 0 16 16" fill="currentColor" className="h-4 w-4">
+        <path
+          fillRule="evenodd"
+          d="M8 1a7 7 0 100 14A7 7 0 008 1zm.75 4.5a.75.75 0 00-1.5 0v3.75a.75.75 0 001.5 0V5.5zm-.75 7.25a1 1 0 100-2 1 1 0 000 2z"
+          clipRule="evenodd"
+        />
+      </svg>
+    ),
+  },
+};
+
+interface ToastItemProps {
+  toast: ToastItem;
+  onRemove: () => void;
+}
+
+function ToastEntry({ toast, onRemove }: ToastItemProps) {
+  const [leaving, setLeaving] = useState(false);
+  const style = TYPE_STYLES[toast.type];
+
+  const handleRemove = useCallback(() => {
+    setLeaving(true);
+    setTimeout(onRemove, 190);
+  }, [onRemove]);
+
+  return (
+    <div
+      className={[
+        "flex items-start gap-3 rounded-xl border px-3.5 py-3 shadow-lg",
+        style.wrap,
+        leaving ? "animate-toast-out" : "animate-toast-in",
+      ].join(" ")}
+    >
+      <span className={`mt-0.5 shrink-0 ${style.iconColor}`}>{style.icon}</span>
+      <div className="flex min-w-0 flex-1 flex-col gap-0.5">
+        <p className="text-sm font-semibold leading-tight">{toast.title}</p>
+        {toast.message && (
+          <p className="text-xs opacity-60 leading-snug">{toast.message}</p>
+        )}
+      </div>
+      <button
+        type="button"
+        onClick={handleRemove}
+        className="mt-0.5 shrink-0 opacity-35 transition-opacity hover:opacity-70"
+        aria-label="닫기"
+      >
+        <svg viewBox="0 0 16 16" fill="currentColor" className="h-3.5 w-3.5">
+          <path d="M3.72 3.72a.75.75 0 011.06 0L8 6.94l3.22-3.22a.75.75 0 111.06 1.06L9.06 8l3.22 3.22a.75.75 0 11-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 01-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 010-1.06z" />
+        </svg>
+      </button>
+    </div>
+  );
+}
+
+// ─── Provider ─────────────────────────────────────────────────────────────────
+
+export function ToastProvider({ children }: { children: React.ReactNode }) {
+  const [toasts, setToasts] = useState<ToastItem[]>([]);
+  const timersRef = useRef<Map<string, ReturnType<typeof setTimeout>>>(new Map());
+  const [mounted, setMounted] = useState(false);
+
+  useEffect(() => { setMounted(true); }, []);
+
+  const removeToast = useCallback((id: string) => {
+    setToasts((prev) => prev.filter((t) => t.id !== id));
+    const timer = timersRef.current.get(id);
+    if (timer) {
+      clearTimeout(timer);
+      timersRef.current.delete(id);
+    }
+  }, []);
+
+  const addToast = useCallback(
+    (toast: Omit<ToastItem, "id">) => {
+      const id = `${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
+      setToasts((prev) => [...prev, { ...toast, id }]);
+      const timer = setTimeout(() => removeToast(id), AUTO_DISMISS_MS);
+      timersRef.current.set(id, timer);
+    },
+    [removeToast],
+  );
+
+  return (
+    <ToastContext.Provider value={{ addToast, removeToast }}>
+      {children}
+      {mounted &&
+        createPortal(
+          <div className="pointer-events-none fixed right-4 top-4 z-[9999] flex w-80 flex-col gap-2">
+            {toasts.map((toast) => (
+              <div key={toast.id} className="pointer-events-auto">
+                <ToastEntry toast={toast} onRemove={() => removeToast(toast.id)} />
+              </div>
+            ))}
+          </div>,
+          document.body,
+        )}
+    </ToastContext.Provider>
+  );
+}

package/apps/web/src/store/agentStatusStore.ts

@@ -0,0 +1,38 @@
+import { create } from "zustand";
+
+import { getAuthStatus, getCodexAuthStatus, getGeminiAuthStatus } from "@/features/auth/api/auth.api";
+import type { AgentId } from "@/features/chat/ui/AgentSelectModal";
+import type { ConnectionStatus } from "@/features/chat/hooks/useUnifiedSessions";
+
+interface AgentStatusState {
+  statusByAgent: Record<AgentId, ConnectionStatus>;
+  loading: boolean;
+  refresh: () => Promise<void>;
+}
+
+export const useAgentStatusStore = create<AgentStatusState>((set) => ({
+  statusByAgent: {
+    claude: "disconnected",
+    gemini: "disconnected",
+    codex: "disconnected",
+    opencode: "disconnected",
+  },
+  loading: false,
+  refresh: async () => {
+    set({ loading: true });
+    const [claude, gemini, codex] = await Promise.allSettled([
+      getAuthStatus(),
+      getGeminiAuthStatus(),
+      getCodexAuthStatus(),
+    ]);
+    set({
+      loading: false,
+      statusByAgent: {
+        claude: claude.status === "fulfilled" && claude.value.loggedIn ? "connected" : "disconnected",
+        gemini: gemini.status === "fulfilled" && gemini.value.loggedIn && gemini.value.installed ? "connected" : "disconnected",
+        codex: codex.status === "fulfilled" && codex.value.loggedIn && codex.value.installed ? "connected" : "disconnected",
+        opencode: "disconnected",
+      },
+    });
+  },
+}));

package/apps/web/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "@ji/typescript-config/nextjs.json",
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "jsx": "react-jsx",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}

package/apps/web/vitest.config.ts

@@ -0,0 +1,25 @@
+import path from "path";
+
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    environment: "jsdom",
+    setupFiles: ["./vitest.setup.ts"],
+    globals: true,
+    css: false,
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "lcov"],
+      include: ["src/features/**", "src/lib/**", "src/components/**"],
+      exclude: ["**/__tests__/**", "**/*.d.ts"],
+    },
+  },
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./src"),
+    },
+  },
+});

package/apps/web/vitest.setup.ts

@@ -0,0 +1,10 @@
+import "@testing-library/jest-dom";
+
+// crypto.randomUUID polyfill for jsdom
+if (!globalThis.crypto.randomUUID) {
+  (globalThis.crypto as { randomUUID?: unknown }).randomUUID = () =>
+    "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = Math.floor(Math.random() * 16);
+      return (c === "x" ? r : (r & 0x3) | 0x8).toString(16);
+    });
+}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@jcjeon/integration-cli",
+  "version": "0.2.0",
+  "private": false,
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Local web workspace for Claude Code, Gemini CLI, and Codex tasks",
+  "bin": {
+    "jccli": "./packages/cli/dist/index.js"
+  },
+  "files": [
+    ".gitignore",
+    ".npmignore",
+    ".prettierignore",
+    ".prettierrc",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "README.md",
+    "apps/server/.gitignore",
+    "apps/server/README.md",
+    "apps/server/eslint.config.mjs",
+    "apps/server/nest-cli.json",
+    "apps/server/package.json",
+    "apps/server/scripts",
+    "apps/server/src",
+    "apps/server/test",
+    "apps/server/tsconfig.build.json",
+    "apps/server/tsconfig.json",
+    "apps/web/.gitignore",
+    "apps/web/AGENTS.md",
+    "apps/web/CLAUDE.md",
+    "apps/web/README.md",
+    "apps/web/eslint.config.mjs",
+    "apps/web/next-env.d.ts",
+    "apps/web/next.config.ts",
+    "apps/web/package.json",
+    "apps/web/postcss.config.mjs",
+    "apps/web/public",
+    "apps/web/src",
+    "apps/web/tsconfig.json",
+    "apps/web/vitest.config.ts",
+    "apps/web/vitest.setup.ts",
+    "packages/cli/dist",
+    "packages/cli/package.json",
+    "packages/cli/src",
+    "packages/cli/tsconfig.json",
+    "packages/eslint-config",
+    "packages/typescript-config/base.json",
+    "packages/typescript-config/nestjs.json",
+    "packages/typescript-config/nextjs.json",
+    "packages/typescript-config/package.json",
+    "turbo.json"
+  ],
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
+  "scripts": {
+    "prepack": "npm run build --workspace @ji/cli",
+    "dev": "turbo run dev",
+    "build": "turbo run build",
+    "lint": "turbo run lint",
+    "lint:fix": "turbo run lint:fix",
+    "format": "prettier --write \"**/*.{ts,tsx,js,mjs,json,md,css}\"",
+    "format:check": "prettier --check \"**/*.{ts,tsx,js,mjs,json,md,css}\"",
+    "test": "turbo run test",
+    "clean": "turbo run clean && rm -rf node_modules"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "prettier": "^3.4.2",
+    "prettier-plugin-tailwindcss": "^0.8.0",
+    "turbo": "^2.5.4"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "npm@10.9.7"
+}

package/packages/cli/dist/commands/check.d.ts

@@ -0,0 +1 @@
+export declare function runCheck(): void;

package/packages/cli/dist/commands/check.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCheck = runCheck;
+const os = __importStar(require("os"));
+const chalk_1 = __importDefault(require("chalk"));
+const agent_tools_1 = require("../utils/agent-tools");
+function runCheck() {
+    const platform = (0, agent_tools_1.getPlatform)();
+    const results = agent_tools_1.AGENT_TOOLS.map((tool) => getToolStatus(tool, platform));
+    console.log(chalk_1.default.bold('\n🔍 에이전트 CLI 설치 상태 확인\n'));
+    console.log(chalk_1.default.gray(`플랫폼: ${platform} (${os.arch()})\n`));
+    for (const result of results) {
+        if (result.installed) {
+            console.log(chalk_1.default.green(`  ✓ ${result.name.padEnd(14)} ${result.version ?? ''}`));
+            continue;
+        }
+        console.log(chalk_1.default.red(`  ✗ ${result.name.padEnd(14)} 미설치`));
+        console.log(chalk_1.default.gray(`      설치: npm install -g ${result.packageName}`));
+    }
+    printWindowsClaudeNotice(platform);
+    printSummary(results);
+}
+function getToolStatus(tool, platform) {
+    const installed = (0, agent_tools_1.isCommandAvailable)(tool.command, platform);
+    return {
+        name: tool.name,
+        packageName: tool.packageName,
+        installed,
+        version: installed ? (0, agent_tools_1.getCommandVersion)(tool.command, platform) : null,
+    };
+}
+function printWindowsClaudeNotice(platform) {
+    if (platform !== 'windows')
+        return;
+    const gitBashPath = (0, agent_tools_1.findWindowsGitBashPath)();
+    if (gitBashPath) {
+        console.log(chalk_1.default.gray(`\nClaude Code Git Bash 감지: ${gitBashPath}`));
+        return;
+    }
+    console.log(chalk_1.default.yellow('\nClaude Code 실행에는 Git for Windows 또는 WSL이 필요할 수 있습니다.'));
+}
+function printSummary(results) {
+    const missing = results.filter((result) => !result.installed);
+    console.log();
+    if (missing.length === 0) {
+        console.log(chalk_1.default.bold.green('모든 도구가 설치되어 있습니다.'));
+    }
+    else {
+        console.log(chalk_1.default.yellow(`미설치 도구: ${missing.map((result) => result.name).join(', ')}`));
+        console.log(chalk_1.default.gray('  jccli init 으로 한 번에 설치할 수 있습니다.'));
+    }
+    console.log();
+}

package/packages/cli/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+import { type InitProjectOptions } from '../utils/project-init';
+export interface RunInitOptions extends InitProjectOptions {
+    skipAgents?: boolean;
+}
+export declare function runInit(options?: RunInitOptions): Promise<void>;

package/packages/cli/dist/commands/init.js

@@ -0,0 +1,183 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const os = __importStar(require("os"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const project_init_1 = require("../utils/project-init");
+const agent_tools_1 = require("../utils/agent-tools");
+async function runInit(options = {}) {
+    const platform = (0, agent_tools_1.getPlatform)();
+    const failures = [];
+    console.log(chalk_1.default.bold('\n🚀 jccli init - 프로젝트 초기화\n'));
+    console.log(chalk_1.default.gray(`플랫폼: ${platform} (${os.arch()})`));
+    console.log(chalk_1.default.gray(`Node.js: ${process.version}\n`));
+    if (!validateNodeVersion()) {
+        process.exitCode = 1;
+        return;
+    }
+    if (!validateNpm(platform)) {
+        process.exitCode = 1;
+        return;
+    }
+    const projectReady = (0, project_init_1.ensureProjectReady)(options, platform);
+    if (!projectReady.ok) {
+        process.exitCode = 1;
+        return;
+    }
+    if (options.skipAgents) {
+        printProjectOnlySummary(projectReady.projectRoot);
+        return;
+    }
+    printWindowsClaudeNotice(platform);
+    for (const tool of agent_tools_1.AGENT_TOOLS) {
+        const ok = ensureToolInstalled(tool, platform);
+        if (!ok)
+            failures.push(tool.name);
+    }
+    printSummary(failures, platform, projectReady.projectRoot);
+    if (failures.length > 0) {
+        process.exitCode = 1;
+    }
+}
+function validateNodeVersion() {
+    const nodeMajor = (0, agent_tools_1.getNodeMajorVersion)();
+    if (nodeMajor >= agent_tools_1.MIN_NODE_MAJOR) {
+        console.log(chalk_1.default.green(`✓ Node.js ${process.version}`));
+        return true;
+    }
+    console.error(chalk_1.default.red(`✗ Node.js v${agent_tools_1.MIN_NODE_MAJOR}+ 이상이 필요합니다. 현재: ${process.version}`));
+    console.error(chalk_1.default.yellow('  https://nodejs.org 에서 최신 Node.js를 설치해 주세요.'));
+    return false;
+}
+function validateNpm(platform) {
+    if (!(0, agent_tools_1.isCommandAvailable)('npm', platform)) {
+        console.error(chalk_1.default.red('✗ npm이 설치되어 있지 않습니다.'));
+        console.error(chalk_1.default.yellow('  Node.js 재설치 또는 npm을 먼저 설치해 주세요.'));
+        return false;
+    }
+    const npmVersion = (0, agent_tools_1.getCommandVersion)((0, agent_tools_1.getNpmCommand)(platform), platform) ?? 'unknown';
+    console.log(chalk_1.default.green(`✓ npm v${npmVersion}\n`));
+    return true;
+}
+function printWindowsClaudeNotice(platform) {
+    if (platform !== 'windows')
+        return;
+    const gitBashPath = (0, agent_tools_1.findWindowsGitBashPath)();
+    if (gitBashPath) {
+        console.log(chalk_1.default.gray(`Claude Code Git Bash 감지: ${gitBashPath}\n`));
+        return;
+    }
+    console.log(chalk_1.default.yellow('Claude Code는 Windows 네이티브 실행 시 Git for Windows가 필요할 수 있습니다.'));
+    console.log(chalk_1.default.gray('  설치 후에도 claude 실행이 실패하면 Git for Windows를 설치하거나'));
+    console.log(chalk_1.default.gray('  CLAUDE_CODE_GIT_BASH_PATH 환경 변수를 bash.exe 경로로 설정해 주세요.\n'));
+}
+function ensureToolInstalled(tool, platform) {
+    console.log(chalk_1.default.bold(`[ ${tool.name} ]`));
+    if ((0, agent_tools_1.isCommandAvailable)(tool.command, platform)) {
+        const version = (0, agent_tools_1.getCommandVersion)(tool.command, platform) ?? 'version unknown';
+        console.log(chalk_1.default.green(`✓ 이미 설치됨: ${version}\n`));
+        return true;
+    }
+    console.log(chalk_1.default.yellow(`  미설치 상태입니다. ${tool.packageName} 설치를 시작합니다.`));
+    const spinner = (0, ora_1.default)({
+        text: `${tool.packageName} 전역 설치 중...`,
+        color: 'cyan',
+    }).start();
+    const result = (0, agent_tools_1.installGlobalPackage)(tool.packageName, platform);
+    if (!result.ok) {
+        spinner.fail('설치 실패');
+        printInstallError(result.stderr, result.error, tool, platform);
+        return false;
+    }
+    spinner.succeed('설치 완료');
+    const verifySpinner = (0, ora_1.default)('설치 확인 중...').start();
+    if (!(0, agent_tools_1.isCommandAvailable)(tool.command, platform)) {
+        verifySpinner.fail(`${tool.command} 명령을 찾을 수 없습니다.`);
+        console.log(chalk_1.default.yellow('  새 터미널을 열거나 PATH 설정을 확인해 주세요.\n'));
+        return false;
+    }
+    const version = (0, agent_tools_1.getCommandVersion)(tool.command, platform) ?? 'version unknown';
+    verifySpinner.succeed(`${tool.name} 설치 확인: ${version}`);
+    console.log();
+    return true;
+}
+function printInstallError(stderr, error, tool, platform) {
+    console.error(chalk_1.default.red('\n설치 중 오류가 발생했습니다:'));
+    if (stderr)
+        console.error(chalk_1.default.red(stderr));
+    if (error)
+        console.error(chalk_1.default.red(error));
+    console.error(chalk_1.default.yellow('\n수동 설치 명령:'));
+    console.error(chalk_1.default.gray(`  npm install -g ${tool.packageName}`));
+    if (platform === 'windows' && tool.requiresWindowsGitBash) {
+        console.error(chalk_1.default.gray('  Claude Code 실행에는 Git for Windows 또는 WSL이 필요할 수 있습니다.'));
+    }
+    if (platform !== 'windows') {
+        console.error(chalk_1.default.gray('  권한 오류가 나면 npm global prefix 또는 Node 설치 방식을 확인해 주세요.'));
+    }
+    console.log();
+}
+function printProjectOnlySummary(projectRoot) {
+    console.log(chalk_1.default.bold.green('프로젝트 초기화가 완료되었습니다.\n'));
+    console.log(chalk_1.default.cyan('다음 명령으로 실행할 수 있습니다:'));
+    console.log(chalk_1.default.gray(`  cd ${projectRoot}`));
+    console.log(chalk_1.default.gray('  jccli start   # http://localhost:3020\n'));
+}
+function printSummary(failures, platform, projectRoot) {
+    if (failures.length === 0) {
+        console.log(chalk_1.default.bold.green('모든 에이전트 CLI 설치 확인이 완료되었습니다.\n'));
+        console.log(chalk_1.default.cyan('다음 명령으로 시작할 수 있습니다:'));
+        console.log(chalk_1.default.gray(`  cd ${projectRoot}`));
+        console.log(chalk_1.default.gray('  jccli start   # http://localhost:3020'));
+        console.log();
+        console.log(chalk_1.default.cyan('에이전트 CLI 직접 실행:'));
+        console.log(chalk_1.default.gray('  claude   # Claude Code'));
+        console.log(chalk_1.default.gray('  gemini   # Gemini CLI'));
+        console.log(chalk_1.default.gray('  codex    # OpenAI Codex\n'));
+        if (platform !== 'windows') {
+            console.log(chalk_1.default.yellow('명령을 찾을 수 없으면 터미널을 다시 열거나 셸 설정을 다시 로드해 주세요.'));
+            console.log(chalk_1.default.gray('  source ~/.zshrc  # 또는 ~/.bashrc\n'));
+        }
+        return;
+    }
+    console.log(chalk_1.default.bold.yellow('일부 에이전트 CLI 설치 또는 확인에 실패했습니다.'));
+    console.log(chalk_1.default.yellow(`실패 항목: ${failures.join(', ')}`));
+    console.log(chalk_1.default.gray('위 안내에 따라 수동 설치 또는 PATH 설정을 확인해 주세요.\n'));
+}

package/packages/cli/dist/commands/start.d.ts

@@ -0,0 +1,4 @@
+export interface RunStartOptions {
+    port?: string;
+}
+export declare function runStart(options?: RunStartOptions): Promise<void>;