claude-telegram-bot 0.2.2 → 0.2.4

package/README.ko.md

@@ -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`(문법 검사 후 재시작) · `/id`(채팅 ID 확인) · `/help`(도움말)
+명령어: `/new`(맥락 초기화) · `/cron`(예약 작업 보기·추가·삭제) · `/restart`(문법 검사 후 재시작) · `/status`(봇 상태·버전) · `/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) · `/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) · `/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
@@ -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";
@@ -28,6 +28,14 @@ if (net.setDefaultAutoSelectFamily) net.setDefaultAutoSelectFamily(false);
 
 const SELF = fileURLToPath(import.meta.url); // /restart 자기 문법검사용
 const HERE = dirname(SELF);
+// package.json 버전을 1회만 읽어 캐시 (--version, /status 에서 사용).
+const VERSION = (() => {
+  try {
+    return JSON.parse(readFileSync(join(HERE, "package.json"), "utf8")).version;
+  } catch {
+    return "?";
+  }
+})();
 
 // ── CLI (help / version / init) ───────────────────────────────────────────
 {
@@ -45,7 +53,7 @@ Requires: the claude CLI installed and authenticated on the host.`);
     process.exit(0);
   }
   if (a === "-v" || a === "--version") {
-    console.log(JSON.parse(readFileSync(join(HERE, "package.json"), "utf8")).version);
+    console.log(VERSION);
     process.exit(0);
   }
   if (a === "init") {
@@ -65,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(
@@ -100,6 +128,7 @@ const STR = {
       "• /new — reset conversation context (new session)\n" +
       "• /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" +
       "• /id — show this chat ID\n" +
       `\nWorking dir: ${cfg.projectDir}\nPermission mode: ${cfg.permissionMode}`,
     newSession: "🆕 Started a new conversation (previous context cleared).",
@@ -131,6 +160,14 @@ const STR = {
     extractNoUnderstand: "Couldn't understand the schedule. Try rephrasing.",
     extractBadCron: (cron) => `Couldn't parse cron: ${cron}`,
     extractNoPrompt: "Couldn't find what to run.",
+    status: (i) =>
+      `🤖 ${i.name}\n` +
+      `• Version: ${i.version}\n` +
+      `• Model: ${i.model}\n` +
+      `• Session: ${i.hasSession ? "active" : "none (fresh)"}\n` +
+      `• Scheduled jobs: ${i.jobs}\n` +
+      `• Project: ${i.projectDir}\n` +
+      `• Permission: ${i.permissionMode}`,
   },
   ko: {
     help: () =>
@@ -139,6 +176,7 @@ const STR = {
       "• /new — 대화 맥락 초기화 (새 세션)\n" +
       "• /cron — 예약 작업 보기 · /cron add <자연어>로 추가 · /cron rm <번호>로 삭제\n" +
       "• /restart — 봇 재시작 (문법 검사 후 안전하게)\n" +
+      "• /status — 봇 상태·버전 보기\n" +
       "• /id — 이 채팅 ID 확인\n" +
       `\n작업 폴더: ${cfg.projectDir}\n권한 모드: ${cfg.permissionMode}`,
     newSession: "🆕 새 대화를 시작합니다 (이전 맥락 초기화).",
@@ -169,6 +207,14 @@ const STR = {
     extractNoUnderstand: "일정을 이해하지 못했어요. 다르게 표현해 보세요.",
     extractBadCron: (cron) => `cron 해석 실패: ${cron}`,
     extractNoPrompt: "무엇을 실행할지 찾지 못했어요.",
+    status: (i) =>
+      `🤖 ${i.name}\n` +
+      `• 버전: ${i.version}\n` +
+      `• 모델: ${i.model}\n` +
+      `• 세션: ${i.hasSession ? "이어가는 중" : "없음 (새 세션)"}\n` +
+      `• 예약 작업: ${i.jobs}개\n` +
+      `• 작업 폴더: ${i.projectDir}\n` +
+      `• 권한 모드: ${i.permissionMode}`,
   },
 };
 const t = (l, key, ...a) => {
@@ -182,6 +228,7 @@ const COMMANDS = {
     { command: "new", description: "Reset context (new session)" },
     { command: "cron", description: "List / add / remove scheduled tasks" },
     { command: "restart", description: "Restart the bot (after syntax check)" },
+    { command: "status", description: "Bot status / version" },
     { command: "id", description: "Show this chat ID" },
     { command: "help", description: "Help" },
   ],
@@ -189,6 +236,7 @@ const COMMANDS = {
     { command: "new", description: "대화 맥락 초기화 (새 세션)" },
     { command: "cron", description: "예약 작업 보기·추가·삭제" },
     { command: "restart", description: "봇 재시작 (문법 검사 후)" },
+    { command: "status", description: "봇 상태·버전 보기" },
     { command: "id", description: "이 채팅 ID 확인" },
     { command: "help", description: "도움말" },
   ],
@@ -196,11 +244,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 {
@@ -209,6 +259,7 @@ function saveState(s) {
     console.error("Failed to save state", e);
   }
 }
+migrateData(); // 루트 직하 → .claude-bot/ 1회 이주(있으면) 후 state 로드
 let state = loadState(); // { sessionId?, cron?: [{ id, cron, prompt, label? }], restartNotify? }
 
 // ── 텔레그램 헬퍼 ─────────────────────────────────────────────────────────
@@ -588,7 +639,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}`;
@@ -627,6 +678,21 @@ async function handle(msg) {
     await send(chatId, `chatId: ${chatId}`);
     return;
   }
+  if (text === "/status") {
+    await send(
+      chatId,
+      t(l, "status", {
+        version: VERSION,
+        name: cfg.name || "claude-telegram-bot",
+        model: cfg.model || (l === "ko" ? "(기본값)" : "(default)"),
+        hasSession: Boolean(state.sessionId),
+        jobs: schedule.length,
+        projectDir: cfg.projectDir,
+        permissionMode: cfg.permissionMode || "acceptEdits",
+      }),
+    );
+    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.2",
+  "version": "0.2.4",
   "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": {