saeeol 1.0.5 → 1.0.6

package/package.json

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

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)
 }