saeeol 1.0.5 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "name": "saeeol",
   "type": "module",
   "license": "Apache-2.0",

package/script/build.ts

@@ -55,7 +55,99 @@ const baselineFlag = process.argv.includes("--baseline")
 const skipInstall = process.argv.includes("--skip-install")
 const sourcemapsFlag = process.argv.includes("--sourcemaps")
 const plugin = createSolidTransformPlugin()
-async function copyTreeSitterWasms(outputDir: string) {
+
+// ══════════════════════════════════════════════════════════════════
+//  Tier-based tree-sitter WASM selection
+//
+//  LIGHT  = 5 langs (markdown, json, yaml, toml, tsx)   ~8 MB
+//  CODE   = 15 langs (+ python, rust, go, c, cpp...)     ~18 MB
+//  MASTER = all 37 langs                                  ~50 MB
+// ══════════════════════════════════════════════════════════════════
+
+// ══════════════════════════════════════════════════════════════════
+//  Tier-based external packages
+//  These packages are excluded from the bundle entirely
+// ══════════════════════════════════════════════════════════════════
+
+const allProviderPkgs = [
+  "@ai-sdk/amazon-bedrock",
+  "@ai-sdk/anthropic",
+  "@ai-sdk/azure",
+  "@ai-sdk/google",
+  "@ai-sdk/google-vertex",
+  "@ai-sdk/openai",
+  "@ai-sdk/openai-compatible",
+  "@openrouter/ai-sdk-provider",
+  "@ai-sdk/xai",
+  "@ai-sdk/mistral",
+  "@ai-sdk/groq",
+  "@ai-sdk/deepinfra",
+  "@ai-sdk/cerebras",
+  "@ai-sdk/cohere",
+  "@ai-sdk/gateway",
+  "@ai-sdk/togetherai",
+  "@ai-sdk/perplexity",
+  "@ai-sdk/vercel",
+  "@ai-sdk/alibaba",
+  "gitlab-ai-provider",
+  "venice-ai-sdk-provider",
+]
+
+const lightRequired = new Set([
+  "@ai-sdk/anthropic",
+  "@ai-sdk/openai",
+  "@ai-sdk/openai-compatible",
+  "@ai-sdk/google",
+  "@saeeol/gateway",
+])
+
+const codeRequired = new Set([
+  ...lightRequired,
+  "@ai-sdk/amazon-bedrock",
+  "@ai-sdk/azure",
+  "@ai-sdk/google-vertex",
+  "@openrouter/ai-sdk-provider",
+  "@ai-sdk/groq",
+  "@ai-sdk/deepinfra",
+  "@ai-sdk/gateway",
+  "@ai-sdk/alibaba",
+  "@ai-sdk/cerebras",
+])
+
+function tierExternals(tier: string): string[] {
+  if (tier === "master") return []
+  const required = tier === "light" ? lightRequired : codeRequired
+  return allProviderPkgs.filter((p) => !required.has(p))
+}
+
+const tierArg = process.argv.find((a) => a.startsWith("--tier="))?.split("=")[1] ?? "master"
+
+const treeSitterLanguages: Record<string, string[]> = {
+  light: [
+    "markdown", "markdown_inline",
+    "json",
+    "yaml",
+    "toml",
+    "tsx", "typescript",
+  ],
+  code: [
+    "markdown", "markdown_inline",
+    "json",
+    "yaml",
+    "toml",
+    "tsx", "typescript",
+    "python",
+    "rust",
+    "go",
+    "c", "cpp",
+    "java",
+    "javascript",
+    "bash",
+  ],
+  master: [], // empty = all
+}
+
+async function copyTreeSitterWasms(outputDir: string, tier: string) {
   const runtimeWasmPath = require.resolve("web-tree-sitter/tree-sitter.wasm")
   const languagePackagePath = require.resolve("tree-sitter-wasms/package.json")
   const languageWasmDir = path.join(path.dirname(languagePackagePath), "out")
@@ -64,13 +156,21 @@ async function copyTreeSitterWasms(outputDir: string) {
   await fs.promises.mkdir(targetDir, { recursive: true })
   await fs.promises.copyFile(runtimeWasmPath, path.join(targetDir, "tree-sitter.wasm"))
 
-  const languageWasmFiles = (await fs.promises.readdir(languageWasmDir)).filter((file) => file.endsWith(".wasm"))
+  const allWasmFiles = (await fs.promises.readdir(languageWasmDir)).filter((file) => file.endsWith(".wasm"))
+  const allowed = treeSitterLanguages[tier]
+
+  const filesToCopy = allowed.length === 0
+    ? allWasmFiles
+    : allWasmFiles.filter((file) => {
+        const langName = file.replace("tree-sitter-", "").replace(".wasm", "")
+        return allowed.some((a) => langName === a || langName.startsWith(a + "-"))
+      })
 
   await Promise.all(
-    languageWasmFiles.map((file) => fs.promises.copyFile(path.join(languageWasmDir, file), path.join(targetDir, file))),
+    filesToCopy.map((file) => fs.promises.copyFile(path.join(languageWasmDir, file), path.join(targetDir, file))),
   )
 
-  console.log(`copied ${languageWasmFiles.length + 1} tree-sitter wasm files to ${targetDir}`)
+  console.log(`copied ${filesToCopy.length + 1} tree-sitter wasm files to ${targetDir} (tier=${tier})`)
 }
 
 const allTargets: {
@@ -192,7 +292,7 @@ for (const item of targets) {
     tsconfig: "./tsconfig.json",
     plugins: [plugin],
     sourcemap: Script.release ? "none" : "external",
-    external: ["node-gyp", ...LanceDBRuntime.external], 
+    external: ["node-gyp", ...LanceDBRuntime.external, ...tierExternals(tierArg)],
     format: "esm",
     minify: true,
     splitting: true,
@@ -216,10 +316,11 @@ for (const item of targets) {
       SAEEOL_CHANNEL: `'${Script.channel}'`,
       SAEEOL_LIBC: item.os === "linux" ? `'${item.abi ?? "glibc"}'` : "",
       SAEEOL_BUILD_KIND: Script.release ? `'release'` : `'source'`, 
+      SAEEOL_TIER: `'${tierArg}'`,
     },
   })
 
-  await copyTreeSitterWasms(path.resolve(dir, `dist/${name}/bin`)) 
+  await copyTreeSitterWasms(path.resolve(dir, `dist/${name}/bin`), tierArg)
   if (item.os === "linux") {
     const interpreters: Record<string, string> = {
       x64: "/lib64/ld-linux-x86-64.so.2",

package/src/addons/addon-analytics.ts

@@ -0,0 +1,14 @@
+import type { Addon } from "./types"
+
+// ── analytics: 사용량 통계 + 모델 테스트 + PR ────────────────────────
+export const analytics: Addon = {
+  id: "analytics",
+  category: "analytics",
+  minTier: "master",
+  required: false,
+  commands: [
+    () => import("../cli/cmd/stats").then((m) => ({ StatsCommand: m.StatsCommand })),
+    () => import("../cli/cmd/pr").then((m) => ({ PrCommand: m.PrCommand })),
+    () => import("../saeeol/cli/cmd/roll-call").then((m) => ({ RollCallCommand: m.RollCallCommand })),
+  ],
+}

package/src/addons/addon-core.ts

@@ -0,0 +1,15 @@
+import type { Addon } from "./types"
+
+// ── core: TUI 채팅 + 프롬프트 실행 ──────────────────────────────────
+export const core: Addon = {
+  id: "core",
+  category: "core",
+  minTier: "light",
+  required: true,
+  commands: [
+    () => import("../cli/cmd/tui/thread").then((m) => ({ TuiThreadCommand: m.TuiThreadCommand })),
+    () => import("../cli/cmd/run").then((m) => ({ RunCommand: m.RunCommand })),
+    () => import("../cli/cmd/generate").then((m) => ({ GenerateCommand: m.GenerateCommand })),
+    () => import("../cli/cmd/session").then((m) => ({ SessionCommand: m.SessionCommand })),
+  ],
+}

package/src/addons/addon-data.ts

@@ -0,0 +1,14 @@
+import type { Addon } from "./types"
+
+// ── data: 세션 내보내기/가져오기 + DB ───────────────────────────────
+export const data: Addon = {
+  id: "data",
+  category: "data",
+  minTier: "code",
+  required: true,
+  commands: [
+    () => import("../cli/cmd/export").then((m) => ({ ExportCommand: m.ExportCommand })),
+    () => import("../cli/cmd/import").then((m) => ({ ImportCommand: m.ImportCommand })),
+    () => import("../cli/cmd/db").then((m) => ({ DbCommand: m.DbCommand })),
+  ],
+}

package/src/addons/addon-dev.ts

@@ -0,0 +1,13 @@
+import type { Addon } from "./types"
+
+// ── dev: 에이전트 관리 + 디버깅 ─────────────────────────────────────
+export const dev: Addon = {
+  id: "dev",
+  category: "dev",
+  minTier: "code",
+  required: false,
+  commands: [
+    () => import("../cli/cmd/agent").then((m) => ({ AgentCommand: m.AgentCommand })),
+    () => import("../cli/cmd/debug").then((m) => ({ DebugCommand: m.DebugCommand })),
+  ],
+}

package/src/addons/addon-lifecycle.ts

@@ -0,0 +1,13 @@
+import type { Addon } from "./types"
+
+// ── lifecycle: 설치/업그레이드/제거 ──────────────────────────────────
+export const lifecycle: Addon = {
+  id: "lifecycle",
+  category: "lifecycle",
+  minTier: "light",
+  required: true,
+  commands: [
+    () => import("../cli/cmd/upgrade").then((m) => ({ UpgradeCommand: m.UpgradeCommand })),
+    () => import("../cli/cmd/uninstall").then((m) => ({ UninstallCommand: m.UninstallCommand })),
+  ],
+}

package/src/addons/addon-llm.ts

@@ -0,0 +1,15 @@
+import type { Addon } from "./types"
+
+// ── llm: LLM provider 설정 + 모델 관리 ──────────────────────────────
+export const llm: Addon = {
+  id: "llm",
+  category: "llm",
+  minTier: "light",
+  required: true,
+  commands: [
+    () => import("../cli/cmd/init").then((m) => ({ InitCommand: m.InitCommand })),
+    () => import("../cli/cmd/providers").then((m) => ({ ProvidersCommand: m.ProvidersCommand })),
+    () => import("../cli/cmd/models").then((m) => ({ ModelsCommand: m.ModelsCommand })),
+    () => import("../cli/cmd/config").then((m) => ({ ConfigCLICommand: m.ConfigCommand })),
+  ],
+}

package/src/addons/addon-remote.ts

@@ -0,0 +1,12 @@
+import type { Addon } from "./types"
+
+// ── remote: 실시간 세션 릴레이 ──────────────────────────────────────
+export const remote: Addon = {
+  id: "remote",
+  category: "remote",
+  minTier: "master",
+  required: false,
+  commands: [
+    () => import("../cli/cmd/remote").then((m) => ({ RemoteCommand: m.RemoteCommand })),
+  ],
+}

package/src/addons/addon-server.ts

@@ -0,0 +1,14 @@
+import type { Addon } from "./types"
+
+// ── server: headless 서버 + 원격 연결 + ACP ─────────────────────────
+export const server: Addon = {
+  id: "server",
+  category: "server",
+  minTier: "code",
+  required: true,
+  commands: [
+    () => import("../cli/cmd/serve").then((m) => ({ ServeCommand: m.ServeCommand })),
+    () => import("../cli/cmd/tui/attach").then((m) => ({ AttachCommand: m.AttachCommand })),
+    () => import("../cli/cmd/acp").then((m) => ({ AcpCommand: m.AcpCommand })),
+  ],
+}

package/src/addons/addon-tools.ts

@@ -0,0 +1,13 @@
+import type { Addon } from "./types"
+
+// ── tools: MCP + 플러그인 시스템 ────────────────────────────────────
+export const tools: Addon = {
+  id: "tools",
+  category: "tools",
+  minTier: "code",
+  required: true,
+  commands: [
+    () => import("../cli/cmd/mcp").then((m) => ({ McpCommand: m.McpCommand })),
+    () => import("../cli/cmd/plug").then((m) => ({ PluginCommand: m.PluginCommand })),
+  ],
+}

package/src/addons/addon-web.ts

@@ -0,0 +1,12 @@
+import type { Addon } from "./types"
+
+// ── web: 브라우저 채팅 UI ───────────────────────────────────────────
+export const web: Addon = {
+  id: "web",
+  category: "web",
+  minTier: "master",
+  required: true,
+  commands: [
+    () => import("../cli/cmd/web").then((m) => ({ WebCommand: m.WebCommand })),
+  ],
+}

package/src/addons/registry.ts

@@ -0,0 +1,65 @@
+import type { Addon, Tier } from "./types"
+import { core } from "./addon-core"
+import { llm } from "./addon-llm"
+import { lifecycle } from "./addon-lifecycle"
+import { server } from "./addon-server"
+import { tools } from "./addon-tools"
+import { data } from "./addon-data"
+import { dev } from "./addon-dev"
+import { web } from "./addon-web"
+import { remote } from "./addon-remote"
+import { analytics } from "./addon-analytics"
+
+// ╔══════════════════════════════════════════════════════════════════╗
+// ║  애드온 레지스트리                                               ║
+// ║                                                                   ║
+// ║  LIGHT  = core + llm + lifecycle              (3 addons, 10 cmd)  ║
+// ║  CODE   = LIGHT + server + tools + data + dev (8 addons, 20 cmd) ║
+// ║  MASTER = CODE + web + remote + analytics     (11 addons, 24 cmd)║
+// ╚══════════════════════════════════════════════════════════════════╝
+
+export const allAddons: Addon[] = [
+  // LIGHT
+  core,        // TUI 채팅, run, generate, session
+  llm,         // init, auth, models, config
+  lifecycle,   // upgrade, uninstall
+
+  // CODE
+  server,      // serve, attach, acp
+  tools,       // mcp, plugin
+  data,        // export, import, db
+  dev,         // agent, debug
+
+  // MASTER
+  web,         // web UI
+  remote,      // real-time relay
+  analytics,   // stats, pr, roll-call
+]
+
+const tierPriority: Record<Tier, number> = { light: 0, code: 1, master: 2 }
+
+export function addonsForTier(tier: Tier): Addon[] {
+  return allAddons.filter((a) => tierPriority[tier] >= tierPriority[a.minTier])
+}
+
+export async function commandsForTier(tier: Tier): Promise<any[]> {
+  const addons = addonsForTier(tier)
+  const commands: any[] = []
+  for (const addon of addons) {
+    for (const loader of addon.commands) {
+      const mod = await loader()
+      commands.push(...Object.values(mod))
+    }
+  }
+  return commands
+}
+
+export function manifest(tier: Tier) {
+  const addons = addonsForTier(tier)
+  return addons.map((a) => ({
+    id: a.id,
+    category: a.category,
+    commands: a.commands.length,
+    required: a.required,
+  }))
+}

package/src/addons/types.ts

@@ -0,0 +1,31 @@
+// ╔══════════════════════════════════════════════════════════════════╗
+// ║  SAEEOL 애드온 시스템                                           ║
+// ║                                                                   ║
+// ║  원자 단위 기능 → 애드온 → 티어별 자동 활성화                      ║
+// ║                                                                   ║
+// ║  LIGHT  = core + llm + lifecycle                                  ║
+// ║  CODE   = LIGHT + server + tools + data + dev                     ║
+// ║  MASTER = CODE + web + remote + analytics                         ║
+// ╚══════════════════════════════════════════════════════════════════╝
+
+export type Tier = "light" | "code" | "master"
+
+export interface Addon {
+  /** 애드온 ID */
+  id: string
+  /** 분류 */
+  category: "core" | "llm" | "lifecycle" | "server" | "tools" | "data" | "web" | "remote" | "analytics" | "dev"
+  /** 포함 명령어 */
+  commands: (() => Promise<Record<string, any>>)[]
+  /** 필요 티어 (이 티어부터 활성화) */
+  minTier: Tier
+  /** 필수/선택 */
+  required: boolean
+}
+
+// 티어 우선순위
+const tierPriority: Record<Tier, number> = { light: 0, code: 1, master: 2 }
+
+export function tierActive(addon: Addon, tier: Tier): boolean {
+  return tierPriority[tier] >= tierPriority[addon.minTier]
+}

package/src/index.ts

@@ -1,68 +1,97 @@
 import yargs from "yargs"
 import { hideBin } from "yargs/helpers"
+
+// ╔══════════════════════════════════════════════════════════════════╗
+// ║  SAEEOL CLI — 애드온 아키텍처                                     ║
+// ║                                                                   ║
+// ║  원자 단위 애드온 → 티어별 자동 활성화                              ║
+// ║                                                                   ║
+// ║  LIGHT  = core + llm + lifecycle                                  ║
+// ║  CODE   = LIGHT + server + tools + data + dev                     ║
+// ║  MASTER = CODE + web + remote + analytics                         ║
+// ╚══════════════════════════════════════════════════════════════════╝
+
+// ── LIGHT: core ────────────────────────────────────────────────────
+import { TuiThreadCommand } from "./cli/cmd/tui/thread"
 import { RunCommand } from "./cli/cmd/run"
 import { GenerateCommand } from "./cli/cmd/generate"
-import * as Log from "@saeeol/core/util/log"
-// import { LoginCommand, LogoutCommand, SwitchCommand, OrgsCommand } from "./cli/cmd/account"
-// import { ConsoleCommand } from "./cli/cmd/account"
-import { ConsoleCommand } from "./cli/cmd/account"
+import { SessionCommand } from "./cli/cmd/session"
+
+// ── LIGHT: llm ─────────────────────────────────────────────────────
+import { InitCommand } from "./cli/cmd/init"
 import { ProvidersCommand } from "./cli/cmd/providers"
-import { AgentCommand } from "./cli/cmd/agent"
+import { ModelsCommand } from "./cli/cmd/models"
+import { ConfigCommand as ConfigCLICommand } from "./cli/cmd/config"
+
+// ── LIGHT: lifecycle ───────────────────────────────────────────────
 import { UpgradeCommand } from "./cli/cmd/upgrade"
 import { UninstallCommand } from "./cli/cmd/uninstall"
-import { ModelsCommand } from "./cli/cmd/models"
+
+// ── CODE: server ───────────────────────────────────────────────────
+import { ServeCommand } from "./cli/cmd/serve"
+import { AttachCommand } from "./cli/cmd/tui/attach"
+import { AcpCommand } from "./cli/cmd/acp"
+
+// ── CODE: tools ────────────────────────────────────────────────────
+import { McpCommand } from "./cli/cmd/mcp"
+import { PluginCommand } from "./cli/cmd/plug"
+
+// ── CODE: data ─────────────────────────────────────────────────────
+import { ExportCommand } from "./cli/cmd/export"
+import { ImportCommand } from "./cli/cmd/import"
+import { DbCommand } from "./cli/cmd/db"
+
+// ── CODE: dev (선택) ───────────────────────────────────────────────
+import { AgentCommand } from "./cli/cmd/agent"
+import { DebugCommand } from "./cli/cmd/debug"
+
+// ── MASTER: web ────────────────────────────────────────────────────
+import { WebCommand } from "./cli/cmd/web"
+
+// ── MASTER: remote (선택) ──────────────────────────────────────────
+import { RemoteCommand } from "./cli/cmd/remote"
+
+// ── MASTER: analytics (선택) ───────────────────────────────────────
+import { StatsCommand } from "./cli/cmd/stats"
+import { PrCommand } from "./cli/cmd/pr"
+import { RollCallCommand } from "./saeeol/cli/cmd/roll-call"
+
+// ── DEV 전용 ───────────────────────────────────────────────────────
+import { DevSetupCommand, DevAliasCommand } from "./saeeol/cli/dev-setup"
+
+// ── 공통 ────────────────────────────────────────────────────────────
+import * as Log from "@saeeol/core/util/log"
 import { UI } from "./cli/ui"
 import { Installation } from "./installation"
 import { InstallationBuildKind, InstallationVersion } from "@saeeol/core/installation/version" 
 import { NamedError } from "@saeeol/core/util/error"
 import { FormatError } from "./cli/error"
-import { ServeCommand } from "./cli/cmd/serve"
 import { Filesystem } from "@/util/filesystem"
-import { ConfigCommand as ConfigCLICommand } from "./cli/cmd/config" 
-import { DebugCommand } from "./cli/cmd/debug"
-import { StatsCommand } from "./cli/cmd/stats"
-import { McpCommand } from "./cli/cmd/mcp"
-// import { GithubCommand } from "./cli/cmd/github" 
-import { ExportCommand } from "./cli/cmd/export"
-import { ImportCommand } from "./cli/cmd/import"
-import { AttachCommand } from "./cli/cmd/tui/attach"
-import { TuiThreadCommand } from "./cli/cmd/tui/thread"
-import { AcpCommand } from "./cli/cmd/acp"
 import { EOL } from "os"
-// import { WebCommand } from "./cli/cmd/web" 
-import { PrCommand } from "./cli/cmd/pr"
-import { SessionCommand } from "./cli/cmd/session"
-import { RemoteCommand } from "./cli/cmd/remote" 
-import { RollCallCommand } from "./saeeol/cli/cmd/roll-call" 
-import { DevSetupCommand, DevAliasCommand } from "./saeeol/cli/dev-setup"
-import { WebCommand } from "./cli/cmd/web" 
 import { Telemetry } from "@saeeol/telemetry"
 import { InstanceStore } from "./project/instance-store" 
 import { migrateLegacySaeeolAuth, ENV_FEATURE, ENV_VERSION } from "@saeeol/gateway"
-// (extension, cloud) which set their own SAEEOL_FEATURE env var. Direct CLI use
-// (any command other than 'serve') is tagged as 'cli'. If 'serve' is spawned without
-// the env var, it gets 'unknown' so the misconfiguration is visible in data.
-if (!process.env[ENV_FEATURE]) {
-  const isServe = process.argv.includes("serve")
-  process.env[ENV_FEATURE] = isServe ? "unknown" : "cli"
-}
-if (!process.env[ENV_VERSION]) {
-  process.env[ENV_VERSION] = InstallationVersion
-}
 import { Config } from "./config/config"
 import { Auth } from "./auth"
-import { DbCommand } from "./cli/cmd/db"
 import path from "path"
 import { Global } from "@saeeol/core/global"
 import { createHelpCommand } from "./saeeol/help-command" 
 import { JsonMigration } from "@/storage/json-migration"
 import { Database } from "@/storage/db"
 import { errorMessage } from "./util/error"
-import { PluginCommand } from "./cli/cmd/plug"
-import { InitCommand } from "./cli/cmd/init"
 import { Heap } from "./cli/heap"
 import { drizzle } from "drizzle-orm/bun-sqlite"
 import { ensureProcessMetadata } from "@saeeol/core/util/saeeol-process"
+import type { Tier } from "./addons/types"
+import { addonsForTier, manifest } from "./addons/registry"
+
+if (!process.env[ENV_FEATURE]) {
+  const isServe = process.argv.includes("serve")
+  process.env[ENV_FEATURE] = isServe ? "unknown" : "cli"
+}
+if (!process.env[ENV_VERSION]) {
+  process.env[ENV_VERSION] = InstallationVersion
+}
 
 const processMetadata = ensureProcessMetadata("main")
 
@@ -205,38 +234,71 @@ let cli = yargs(args)
   })
   .usage("")
   .completion("completion", "generate shell completion script")
-  .command(AcpCommand)
-  .command(McpCommand)
-  .command(TuiThreadCommand)
-  .command(AttachCommand)
-  .command(RunCommand)
-  .command(GenerateCommand)
-  .command(DebugCommand)
-  // .command(LoginCommand)
-  // .command(LogoutCommand)
-  // .command(SwitchCommand)
-  // .command(OrgsCommand)
-  // .command(ConsoleCommand)
-  .command(ProvidersCommand)
-  .command(AgentCommand)
-  .command(UpgradeCommand)
-  .command(UninstallCommand)
-  .command(ServeCommand)
-  .command(WebCommand)
-  // .command(WebCommand) 
-  .command(ModelsCommand)
-  .command(RollCallCommand) 
-  .command(StatsCommand)
-  .command(ExportCommand)
-  .command(ImportCommand)
-  // .command(GithubCommand) 
-  .command(PrCommand)
-  .command(SessionCommand)
-  .command(RemoteCommand) 
-  .command(ConfigCLICommand) 
-  .command(PluginCommand)
-  .command(InitCommand)
-  .command(DbCommand)
+
+  // ════════════════════════════════════════════════════════════════
+  //   LIGHT: core (TUI 채팅 + 프롬프트 + 세션)
+  // ════════════════════════════════════════════════════════════════
+  .command(TuiThreadCommand)      // [default]   TUI 채팅
+  .command(RunCommand)            // run         프롬프트 실행
+  .command(GenerateCommand)       // generate    코드 생성
+  .command(SessionCommand)        // session     세션 관리
+
+  // ════════════════════════════════════════════════════════════════
+  //   LIGHT: llm (provider + 모델 + 설정)
+  // ════════════════════════════════════════════════════════════════
+  .command(InitCommand)           // init        최초 설정
+  .command(ProvidersCommand)      // auth        provider 인증
+  .command(ModelsCommand)         // models      모델 목록
+  .command(ConfigCLICommand)      // config      설정 관리
+
+  // ════════════════════════════════════════════════════════════════
+  //   LIGHT: lifecycle (설치/업그레이드/제거)
+  // ════════════════════════════════════════════════════════════════
+  .command(UpgradeCommand)        // upgrade     버전 업그레이드
+  .command(UninstallCommand)      // uninstall   제거
+
+  // ════════════════════════════════════════════════════════════════
+  //   CODE: server (headless + 원격 + ACP)
+  // ════════════════════════════════════════════════════════════════
+  .command(ServeCommand)          // serve       headless 서버
+  .command(AttachCommand)         // attach      원격 연결
+  .command(AcpCommand)            // acp         ACP 서버
+
+  // ════════════════════════════════════════════════════════════════
+  //   CODE: tools (MCP + 플러그인)
+  // ════════════════════════════════════════════════════════════════
+  .command(McpCommand)            // mcp         MCP 서버 관리
+  .command(PluginCommand)         // plugin      플러그인
+
+  // ════════════════════════════════════════════════════════════════
+  //   CODE: data (export + import + db)
+  // ════════════════════════════════════════════════════════════════
+  .command(ExportCommand)         // export      세션 내보내기
+  .command(ImportCommand)         // import      세션 가져오기
+  .command(DbCommand)             // db          데이터베이스
+
+  // ════════════════════════════════════════════════════════════════
+  //   CODE: dev (선택)
+  // ════════════════════════════════════════════════════════════════
+  .command(AgentCommand)          // agent       에이전트 관리
+  .command(DebugCommand)          // debug       디버깅
+
+  // ════════════════════════════════════════════════════════════════
+  //   MASTER: web (브라우저 채팅 UI)
+  // ════════════════════════════════════════════════════════════════
+  .command(WebCommand)            // web         웹 UI + 브라우저
+
+  // ════════════════════════════════════════════════════════════════
+  //   MASTER: remote (선택)
+  // ════════════════════════════════════════════════════════════════
+  .command(RemoteCommand)         // remote      실시간 릴레이
+
+  // ════════════════════════════════════════════════════════════════
+  //   MASTER: analytics (선택)
+  // ════════════════════════════════════════════════════════════════
+  .command(StatsCommand)          // stats       사용량 통계
+  .command(PrCommand)             // pr          GitHub PR
+  .command(RollCallCommand)       // roll-call   모델 연결 테스트
 if (InstallationBuildKind !== "release") {
   cli = cli.command(DevSetupCommand).command(DevAliasCommand)
 }

package/src/provider/bundled-providers.ts

@@ -1,4 +1,3 @@
-import { SAEEOL_BUNDLED_PROVIDERS } from "@/saeeol/provider/provider"
 import type { BundledSDK } from "./provider-types"
 
 export function shouldUseCopilotResponsesApi(modelID: string): boolean {
@@ -11,30 +10,32 @@ export function useLanguageModel(sdk: any) {
   return sdk.responses === undefined && sdk.chat === undefined
 }
 
-export const BUNDLED_PROVIDERS: Record<string, () => Promise<(opts: any) => BundledSDK>> = {
-  "@ai-sdk/amazon-bedrock": () => import("@ai-sdk/amazon-bedrock").then((m) => m.createAmazonBedrock),
-  "@ai-sdk/anthropic": () => import("@ai-sdk/anthropic").then((m) => m.createAnthropic),
-  "@ai-sdk/azure": () => import("@ai-sdk/azure").then((m) => m.createAzure),
-  "@ai-sdk/google": () => import("@ai-sdk/google").then((m) => m.createGoogleGenerativeAI),
-  "@ai-sdk/google-vertex": () => import("@ai-sdk/google-vertex").then((m) => m.createVertex),
-  "@ai-sdk/google-vertex/anthropic": () =>
-    import("@ai-sdk/google-vertex/anthropic").then((m) => m.createVertexAnthropic),
-  "@ai-sdk/openai": () => import("@ai-sdk/openai").then((m) => m.createOpenAI),
-  "@ai-sdk/openai-compatible": () => import("@ai-sdk/openai-compatible").then((m) => m.createOpenAICompatible),
-  "@openrouter/ai-sdk-provider": () => import("@openrouter/ai-sdk-provider").then((m) => m.createOpenRouter),
-  "@ai-sdk/xai": () => import("@ai-sdk/xai").then((m) => m.createXai),
-  "@ai-sdk/mistral": () => import("@ai-sdk/mistral").then((m) => m.createMistral),
-  "@ai-sdk/groq": () => import("@ai-sdk/groq").then((m) => m.createGroq),
-  "@ai-sdk/deepinfra": () => import("@ai-sdk/deepinfra").then((m) => m.createDeepInfra),
-  "@ai-sdk/cerebras": () => import("@ai-sdk/cerebras").then((m) => m.createCerebras),
-  "@ai-sdk/cohere": () => import("@ai-sdk/cohere").then((m) => m.createCohere),
-  "@ai-sdk/gateway": () => import("@ai-sdk/gateway").then((m) => m.createGateway),
-  "@ai-sdk/togetherai": () => import("@ai-sdk/togetherai").then((m) => m.createTogetherAI),
-  "@ai-sdk/perplexity": () => import("@ai-sdk/perplexity").then((m) => m.createPerplexity),
-  "@ai-sdk/vercel": () => import("@ai-sdk/vercel").then((m) => m.createVercel),
-  "@ai-sdk/alibaba": () => import("@ai-sdk/alibaba").then((m) => m.createAlibaba),
-  "gitlab-ai-provider": () => import("gitlab-ai-provider").then((m) => m.createGitLab),
-  "@ai-sdk/github-copilot": () => import("./sdk/copilot/copilot-provider").then((m) => m.createOpenaiCompatible),
-  "venice-ai-sdk-provider": () => import("venice-ai-sdk-provider").then((m) => m.createVenice),
-  ...SAEEOL_BUNDLED_PROVIDERS,
+// ╔══════════════════════════════════════════════════════════════════╗
+// ║  티어별 provider 로딩                                            ║
+// ║                                                                   ║
+// ║  SAEEOL_TIER는 build.ts define으로 "light"|"code"|"master" 주입    ║
+// ║  Bun은 dead branch를 제거하므로 다른 티어의 import()가 제외됨      ║
+// ╚══════════════════════════════════════════════════════════════════╝
+
+declare const SAEEOL_TIER: string
+
+type ProviderLoader = () => Promise<(opts: any) => BundledSDK>
+
+// 티어별 파일에서 각각 서로 다른 provider 집합을 import
+// Bun은 조건에 맞지 않는 branch의 import()를 dead code로 처리
+
+function getProviders(): Record<string, ProviderLoader> {
+  if (SAEEOL_TIER === "light") {
+    // Bun replaces SAEEOL_TIER with literal, dead-eliminates else branches
+    const m = require("./tiers/light") as typeof import("./tiers/light")
+    return m.lightProviders
+  }
+  if (SAEEOL_TIER === "code") {
+    const m = require("./tiers/code") as typeof import("./tiers/code")
+    return m.codeProviders
+  }
+  const m = require("./tiers/master") as typeof import("./tiers/master")
+  return m.masterProviders
 }
+
+export const BUNDLED_PROVIDERS: Record<string, ProviderLoader> = getProviders()

package/src/provider/tiers/code.ts

@@ -0,0 +1,21 @@
+// CODE 티어 provider 맵 — LIGHT + 개발용 provider
+import type { BundledSDK } from "../../provider/provider-types"
+import { createSaeeol } from "@saeeol/gateway"
+import { lightProviders } from "./light"
+
+type L = () => Promise<(opts: any) => BundledSDK>
+
+export const codeProviders: Record<string, L> = {
+  ...lightProviders,
+  "@ai-sdk/amazon-bedrock": () => import("@ai-sdk/amazon-bedrock").then((m) => m.createAmazonBedrock),
+  "@ai-sdk/azure": () => import("@ai-sdk/azure").then((m) => m.createAzure),
+  "@ai-sdk/google-vertex": () => import("@ai-sdk/google-vertex").then((m) => m.createVertex),
+  "@ai-sdk/google-vertex/anthropic": () =>
+    import("@ai-sdk/google-vertex/anthropic").then((m) => m.createVertexAnthropic),
+  "@openrouter/ai-sdk-provider": () => import("@openrouter/ai-sdk-provider").then((m) => m.createOpenRouter),
+  "@ai-sdk/groq": () => import("@ai-sdk/groq").then((m) => m.createGroq),
+  "@ai-sdk/deepinfra": () => import("@ai-sdk/deepinfra").then((m) => m.createDeepInfra),
+  "@ai-sdk/gateway": () => import("@ai-sdk/gateway").then((m) => m.createGateway),
+  "@ai-sdk/alibaba": () => import("@ai-sdk/alibaba").then((m) => m.createAlibaba),
+  "@ai-sdk/cerebras": () => import("@ai-sdk/cerebras").then((m) => m.createCerebras),
+}

package/src/provider/tiers/light.ts

@@ -0,0 +1,14 @@
+// LIGHT 티어 provider 맵 — 최소 provider만
+import type { BundledSDK } from "../../provider/provider-types"
+import { createSaeeol } from "@saeeol/gateway"
+
+type L = () => Promise<(opts: any) => BundledSDK>
+
+export const lightProviders: Record<string, L> = {
+  "@saeeol/gateway": async () => createSaeeol as any,
+  "@ai-sdk/anthropic": () => import("@ai-sdk/anthropic").then((m) => m.createAnthropic),
+  "@ai-sdk/openai": () => import("@ai-sdk/openai").then((m) => m.createOpenAI),
+  "@ai-sdk/openai-compatible": () => import("@ai-sdk/openai-compatible").then((m) => m.createOpenAICompatible),
+  "@ai-sdk/google": () => import("@ai-sdk/google").then((m) => m.createGoogleGenerativeAI),
+  "@ai-sdk/github-copilot": () => import("../sdk/copilot/copilot-provider").then((m) => m.createOpenaiCompatible),
+}

package/src/provider/tiers/master.ts

@@ -0,0 +1,17 @@
+// MASTER 티어 provider 맵 — 전체 provider
+import type { BundledSDK } from "../../provider/provider-types"
+import { codeProviders } from "./code"
+
+type L = () => Promise<(opts: any) => BundledSDK>
+
+export const masterProviders: Record<string, L> = {
+  ...codeProviders,
+  "@ai-sdk/xai": () => import("@ai-sdk/xai").then((m) => m.createXai),
+  "@ai-sdk/mistral": () => import("@ai-sdk/mistral").then((m) => m.createMistral),
+  "@ai-sdk/cohere": () => import("@ai-sdk/cohere").then((m) => m.createCohere),
+  "@ai-sdk/togetherai": () => import("@ai-sdk/togetherai").then((m) => m.createTogetherAI),
+  "@ai-sdk/perplexity": () => import("@ai-sdk/perplexity").then((m) => m.createPerplexity),
+  "@ai-sdk/vercel": () => import("@ai-sdk/vercel").then((m) => m.createVercel),
+  "gitlab-ai-provider": () => import("gitlab-ai-provider").then((m) => m.createGitLab),
+  "venice-ai-sdk-provider": () => import("venice-ai-sdk-provider").then((m) => m.createVenice),
+}