claude-telegram-bot 0.2.3 → 0.2.5

package/README.ko.md

@@ -92,7 +92,7 @@ claude-telegram-bot ~/botconfigs/myproj/config.json
 | `projectDir` | Claude가 작업할 폴더의 절대경로 |
 | `claudeBin` | `which claude` 결과 (절대경로 권장) |
 | `permissionMode` | `plan`(읽기·계획만) / `acceptEdits`(편집 자동 승인) / `bypassPermissions`(쉘 포함 전부 자동) |
-| `model` | 비우면 기본 모델. `opus`, `sonnet` 등 |
+| `model` | 비우면 기본 모델. `opus`, `sonnet` 등. 런타임에 `/model`로 전환 가능(state에 저장) |
 | `lang` | (선택) UI 언어. 비우면 사용자별 자동 판별(기본 영어, 텔레그램이 한국어면 한국어). `"en"`/`"ko"`로 고정 가능 |
 | `name` | (선택) `/help`에 표시되는 봇 이름. 여러 봇 구분용 |
 | `persona` | (선택) 역할 시스템 프롬프트. 페르소나 봇 정의용 |
@@ -100,7 +100,7 @@ claude-telegram-bot ~/botconfigs/myproj/config.json
 | `env` | (선택) `claude` 프로세스에 넘길 환경 변수 |
 | `schedule` | (선택) 정해진 시각에 프롬프트를 실행하는 cron 작업 — [예약 작업](#예약-작업-cron) 참고 |
 
-`state.json`과 첨부 파일(`attachments/`)은 config 파일과 같은 폴더에 저장됩니다. 그래서 config만 따로 두면 프로젝트끼리 섞이지 않습니다.
+`state`와 첨부 파일은 config 파일 옆 **`.claude-bot/` 숨김 폴더**에 저장됩니다(프로젝트 격리). 구버전에서 올리면 첫 시작 때 기존 `state.json`·`attachments/`를 `.claude-bot/`로 **자동 이동**합니다(무손실). 로그는 launchd plist가 가리키는 위치 그대로입니다.
 
 ## 첫 실행
 
@@ -110,7 +110,7 @@ claude-telegram-bot ~/botconfigs/myproj/config.json
    - `테스트 돌려보고 통과하면 커밋하고 push 해줘`
    - `api.ts 에 에러 핸들링 추가해줘`
 
-명령어: `/new`(맥락 초기화) · `/cron`(예약 작업 보기·추가·삭제) · `/restart`(문법 검사 후 재시작) · `/status`(봇 상태·버전) · `/id`(채팅 ID 확인) · `/help`(도움말)
+명령어: `/new`(맥락 초기화) · `/cron`(예약 작업 보기·추가·삭제) · `/restart`(문법 검사 후 재시작) · `/status`(봇 상태·버전) · `/model`(모델 보기·전환) · `/id`(채팅 ID 확인) · `/help`(도움말)
 
 > **`/restart`** 는 먼저 `bot.mjs` 에 `node --check` 를 돌려 **문법 오류가 있으면 재시작을 취소**합니다(잘못된 수정이 봇을 크래시 루프에 빠뜨리는 것 방지). 통과하면 프로세스를 종료하고, 다시 띄우는 건 프로세스 관리자에게 맡깁니다. [launchd 설정](#상시-실행-launchd)(`KeepAlive`)이면 바로 동작하고, 관리자 없이 `node bot.mjs` 로만 돌리면 그냥 멈춥니다. 재시작 후 대화 세션은 `state.json` 의 ID로 이어집니다.
 

package/README.md

@@ -154,7 +154,7 @@ auth layer.)
 - `run the solver tests and commit + push if they pass`
 - `add an edge case to solve-2nd-floor-edges.ts`
 
-Commands: `/new` (reset context / new session) · `/cron` (list / add / remove scheduled tasks) · `/restart` (syntax-check & restart the bot) · `/status` (bot status & version) · `/id` (show chat ID) · `/help`.
+Commands: `/new` (reset context / new session) · `/cron` (list / add / remove scheduled tasks) · `/restart` (syntax-check & restart the bot) · `/status` (bot status & version) · `/model` (view / switch the model) · `/id` (show chat ID) · `/help`.
 
 > **`/restart`** runs `node --check` on `bot.mjs` first and **aborts the restart if it has a syntax
 > error** (so a bad edit can't crash-loop the bot), then exits — relying on a process supervisor
@@ -184,7 +184,7 @@ Edit `config.json`:
 | `projectDir` | Absolute path to the working folder Claude runs in |
 | `claudeBin` | Output of `which claude` (absolute path recommended) |
 | `permissionMode` | `plan` / `acceptEdits` / `bypassPermissions` — see [Security](#security) |
-| `model` | Empty = default. Or `opus` / `sonnet`, etc. |
+| `model` | Empty = default. Or `opus` / `sonnet`, etc. Override at runtime with `/model` (persists in state). |
 | `lang` | (optional) UI language. Empty = auto-detect per user (English default, Korean for Korean Telegram clients). Force with `"en"` / `"ko"`. |
 | `name` | (optional) Bot name shown in `/help` — handy for telling multiple bots apart |
 | `persona` | (optional) Role system prompt — defines a persona (developer/planner/…). See below |
@@ -192,8 +192,10 @@ Edit `config.json`:
 | `env` | (optional) Extra environment variables passed to the `claude` process |
 | `schedule` | (optional) Cron jobs that run a prompt on a timer — see [Scheduled tasks](#scheduled-tasks-cron) |
 
-State (`state.json`) and downloaded `attachments/` are written **next to the config file**, so
-projects stay isolated.
+State and downloaded attachments live in a hidden **`.claude-bot/`** folder next to the config
+file, so projects stay isolated. Upgrading from an older version **auto-moves** an existing
+`state.json` / `attachments/` into `.claude-bot/` on first start (no data loss). Logs stay wherever
+your launchd plist points them.
 
 ### Usage details
 

package/bot.mjs

@@ -14,7 +14,7 @@
 // 자동 판별하고, cfg.lang 을 주면 그 언어로 고정함. 콘솔/CLI 출력은 영어 단일.
 
 import { basename, dirname, join } from "node:path";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 
 import dns from "node:dns";
 import { fileURLToPath } from "node:url";
@@ -73,13 +73,33 @@ Requires: the claude CLI installed and authenticated on the host.`);
 // isolated. Falls back to ./config.json for the single-project setup.
 const CONFIG_PATH = process.argv[2] || process.env.BOT_CONFIG || join(HERE, "config.json");
 const DATA_DIR = dirname(CONFIG_PATH);
-// state 파일은 config 이름에서 파생 → 같은 폴더에 여러 페르소나 config 를 둬도 세션이 안 섞임.
-// config.json → state.json (단일 봇 호환), 그 외 foo.json → foo.state.json.
+// 데이터(state·attachments)는 config 폴더 아래 숨김 폴더 .claude-bot/ 에 모은다.
+// state 파일명은 config 이름에서 파생 → 여러 페르소나 config 가 한 .claude-bot/ 를 공유해도 안 섞임
+// (config.json → state.json, 그 외 foo.json → foo.state.json).
 const stateBase = basename(CONFIG_PATH, ".json");
-const STATE_PATH = join(
-  DATA_DIR,
-  stateBase === "config" ? "state.json" : `${stateBase}.state.json`,
-);
+const stateFile = stateBase === "config" ? "state.json" : `${stateBase}.state.json`;
+const BOT_DIR = join(DATA_DIR, ".claude-bot");
+const STATE_PATH = join(BOT_DIR, stateFile);
+const ATTACH_DIR = join(BOT_DIR, "attachments");
+const LEGACY_STATE_PATH = join(DATA_DIR, stateFile); // 구버전(루트 직하) 호환
+const LEGACY_ATTACH_DIR = join(DATA_DIR, "attachments");
+
+// 구버전에서 올라온 경우, 루트 직하 데이터를 .claude-bot/ 로 1회 이동(무손실, 실패 시 기존 경로 폴백).
+function migrateData() {
+  try {
+    mkdirSync(BOT_DIR, { recursive: true });
+    if (!existsSync(STATE_PATH) && existsSync(LEGACY_STATE_PATH)) {
+      renameSync(LEGACY_STATE_PATH, STATE_PATH);
+      console.log(`Migrated state → ${STATE_PATH}`);
+    }
+    if (!existsSync(ATTACH_DIR) && existsSync(LEGACY_ATTACH_DIR)) {
+      renameSync(LEGACY_ATTACH_DIR, ATTACH_DIR);
+      console.log(`Migrated attachments → ${ATTACH_DIR}`);
+    }
+  } catch (e) {
+    console.error("Data migration skipped:", e.message);
+  }
+}
 
 if (!existsSync(CONFIG_PATH)) {
   console.error(
@@ -109,6 +129,7 @@ const STR = {
       "• /cron — list tasks · /cron add <natural language> to add · /cron rm <id> to remove\n" +
       "• /restart — restart the bot (after a syntax check)\n" +
       "• /status — bot status & version\n" +
+      "• /model — view / switch the model\n" +
       "• /id — show this chat ID\n" +
       `\nWorking dir: ${cfg.projectDir}\nPermission mode: ${cfg.permissionMode}`,
     newSession: "🆕 Started a new conversation (previous context cleared).",
@@ -148,6 +169,12 @@ const STR = {
       `• Scheduled jobs: ${i.jobs}\n` +
       `• Project: ${i.projectDir}\n` +
       `• Permission: ${i.permissionMode}`,
+    modelStatus: (cur, list) =>
+      `🧠 Model: ${cur}\n` +
+      `Switch: ${list.map((x) => `/model ${x}`).join(" · ")} (or a full model id)\n` +
+      `/model default — clear the override`,
+    modelSet: (m) => `🧠 Model set to: ${m}`,
+    modelReset: (def) => `🧠 Model reset to default (${def}).`,
   },
   ko: {
     help: () =>
@@ -157,6 +184,7 @@ const STR = {
       "• /cron — 예약 작업 보기 · /cron add <자연어>로 추가 · /cron rm <번호>로 삭제\n" +
       "• /restart — 봇 재시작 (문법 검사 후 안전하게)\n" +
       "• /status — 봇 상태·버전 보기\n" +
+      "• /model — 모델 보기·전환\n" +
       "• /id — 이 채팅 ID 확인\n" +
       `\n작업 폴더: ${cfg.projectDir}\n권한 모드: ${cfg.permissionMode}`,
     newSession: "🆕 새 대화를 시작합니다 (이전 맥락 초기화).",
@@ -195,6 +223,12 @@ const STR = {
       `• 예약 작업: ${i.jobs}개\n` +
       `• 작업 폴더: ${i.projectDir}\n` +
       `• 권한 모드: ${i.permissionMode}`,
+    modelStatus: (cur, list) =>
+      `🧠 현재 모델: ${cur}\n` +
+      `전환: ${list.map((x) => `/model ${x}`).join(" · ")} (또는 전체 모델 ID)\n` +
+      `/model default — 오버라이드 해제`,
+    modelSet: (m) => `🧠 모델을 ${m} (으)로 설정했습니다.`,
+    modelReset: (def) => `🧠 모델을 기본값(${def})으로 되돌렸습니다.`,
   },
 };
 const t = (l, key, ...a) => {
@@ -202,6 +236,9 @@ const t = (l, key, ...a) => {
   return typeof v === "function" ? v(...a) : v;
 };
 
+// /model 에서 보여줄 추천 별칭(claude CLI 가 별칭·전체 모델 ID 모두 허용).
+const MODEL_SUGGESTIONS = ["opus", "sonnet", "haiku"];
+
 // /(슬래시) 자동완성 메뉴용 명령 목록 (언어별). setMyCommands 로 등록.
 const COMMANDS = {
   en: [
@@ -209,6 +246,7 @@ const COMMANDS = {
     { command: "cron", description: "List / add / remove scheduled tasks" },
     { command: "restart", description: "Restart the bot (after syntax check)" },
     { command: "status", description: "Bot status / version" },
+    { command: "model", description: "View / switch the model" },
     { command: "id", description: "Show this chat ID" },
     { command: "help", description: "Help" },
   ],
@@ -217,6 +255,7 @@ const COMMANDS = {
     { command: "cron", description: "예약 작업 보기·추가·삭제" },
     { command: "restart", description: "봇 재시작 (문법 검사 후)" },
     { command: "status", description: "봇 상태·버전 보기" },
+    { command: "model", description: "모델 보기·전환" },
     { command: "id", description: "이 채팅 ID 확인" },
     { command: "help", description: "도움말" },
   ],
@@ -224,11 +263,13 @@ const COMMANDS = {
 
 // ── 상태 (세션 이어가기용) ────────────────────────────────────────────────
 function loadState() {
-  try {
-    return JSON.parse(readFileSync(STATE_PATH, "utf8"));
-  } catch {
-    return {};
+  // 새 경로(.claude-bot/) 우선, 없으면 구버전 루트 경로로 폴백(이주 실패 시 안전망).
+  for (const p of [STATE_PATH, LEGACY_STATE_PATH]) {
+    try {
+      return JSON.parse(readFileSync(p, "utf8"));
+    } catch {}
   }
+  return {};
 }
 function saveState(s) {
   try {
@@ -237,7 +278,8 @@ function saveState(s) {
     console.error("Failed to save state", e);
   }
 }
-let state = loadState(); // { sessionId?, cron?: [{ id, cron, prompt, label? }], restartNotify? }
+migrateData(); // 루트 직하 → .claude-bot/ 1회 이주(있으면) 후 state 로드
+let state = loadState(); // { sessionId?, cron?: [{ id, cron, prompt, label? }], restartNotify?, model? }
 
 // ── 텔레그램 헬퍼 ─────────────────────────────────────────────────────────
 async function tg(method, body) {
@@ -353,7 +395,8 @@ function runClaude(prompt, sessionId) {
     // 페르소나(cfg.persona) + 간결 지침을 함께 주입 → 멀티 봇(역할별) 운영용
     const appendSys = [cfg.persona, brevity].filter(Boolean).join("\n\n");
     if (appendSys) args.push("--append-system-prompt", appendSys);
-    if (cfg.model) args.push("--model", cfg.model);
+    const model = state.model || cfg.model; // /model 로 바꾸면 state.model 우선
+    if (model) args.push("--model", model);
     if (sessionId) args.push("--resume", sessionId);
 
     const child = spawn(cfg.claudeBin || "claude", args, {
@@ -616,7 +659,7 @@ async function downloadAttachment(att) {
   const r = await fetch(`https://api.telegram.org/file/bot${cfg.token}/${filePath}`);
   if (!r.ok) throw new Error(`download failed ${r.status}`);
   const buf = Buffer.from(await r.arrayBuffer());
-  const dir = join(DATA_DIR, "attachments");
+  const dir = ATTACH_DIR;
   mkdirSync(dir, { recursive: true });
   const ext = filePath.includes(".") ? filePath.slice(filePath.lastIndexOf(".")) : "";
   const name = att.name || `tg-${att.fileId.slice(-10)}${ext}`;
@@ -661,7 +704,7 @@ async function handle(msg) {
       t(l, "status", {
         version: VERSION,
         name: cfg.name || "claude-telegram-bot",
-        model: cfg.model || (l === "ko" ? "(기본값)" : "(default)"),
+        model: state.model || cfg.model || (l === "ko" ? "(기본값)" : "(default)"),
         hasSession: Boolean(state.sessionId),
         jobs: schedule.length,
         projectDir: cfg.projectDir,
@@ -670,6 +713,24 @@ async function handle(msg) {
     );
     return;
   }
+  if (text === "/model" || text.startsWith("/model ")) {
+    const arg = text.slice(6).trim();
+    if (!arg) {
+      const cur = state.model || cfg.model || (l === "ko" ? "(기본값)" : "(default)");
+      await send(chatId, t(l, "modelStatus", cur, MODEL_SUGGESTIONS));
+      return;
+    }
+    if (arg === "default" || arg === "reset") {
+      state.model = undefined;
+      saveState(state);
+      await send(chatId, t(l, "modelReset", cfg.model || (l === "ko" ? "기본값" : "default")));
+      return;
+    }
+    state.model = arg;
+    saveState(state);
+    await send(chatId, t(l, "modelSet", arg));
+    return;
+  }
   if (text === "/cron" || text.startsWith("/cron ")) {
     await handleCron(chatId, text.slice(5).trim(), l);
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-telegram-bot",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Drive Claude Code from Telegram — messages run headless `claude -p` in a project dir and replies come back to the chat. Zero dependencies.",
   "type": "module",
   "bin": {