claude-telegram-bot 0.2.1 → 0.2.3

package/README.ko.md

@@ -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로 이어집니다.
 
@@ -136,6 +136,7 @@ config에 `schedule` 배열을 두면 정해진 시각에 프롬프트를 자동
 - **`cron`** — 표준 5필드 `분 시 일 월 요일` (예: `0 9 * * 1-5` = 평일 09:00). `*`, 목록(`1,3,5`), 범위(`1-5`), 스텝(`*/15`)을 지원합니다. 요일 `0`과 `7`은 둘 다 일요일. 시각은 **호스트의 로컬 시간대** 기준입니다. 외부 의존성 없이 파서가 `bot.mjs` 안에 들어 있습니다.
 - **`prompt`**(필수) — Claude에게 보낼 메시지. **`label`**(선택) — 답장 푸터와 `/cron` 목록에 표시되는 짧은 이름.
 - **새 세션** — 예약 작업은 **독립된 세션**으로 돌아가서 내 대화 맥락을 오염시키지 않습니다(`state.json`은 내 것 그대로). 단일 작업 락을 공유하므로, 발사 시점에 다른 작업이 진행 중이면 그 회차는 **건너뜁니다**(로그 남김).
+- **조용한 작업(조건부 알림)** — Claude의 출력이 **비었거나 정확히 `SKIP`**이면 그 회차는 텔레그램으로 **아무것도 보내지 않습니다**. "조건이 맞을 때만 알리고 평소엔 조용히" 하고 싶을 때, 프롬프트에 *"조건이 아니면 다른 말 없이 `SKIP`만 출력해"* 라고 적으면 됩니다. 자주 도는 작업(예: 5분마다)도 스팸 없이 쓸 수 있습니다.
 
 **채팅에서 자연어로 추가하기**
 

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
@@ -231,6 +231,10 @@ checks, reminders. Each entry runs the prompt and sends the result to `allowedCh
 - **Fresh session**: scheduled jobs run in their **own session** so they never pollute your
   interactive conversation context (`state.json` stays yours). They share the single-task lock,
   so a job is **skipped** (logged) if a task is already running when it fires.
+- **Silent jobs (conditional alerts)**: if Claude's output is **empty or exactly `SKIP`**, that run
+  sends **nothing** to Telegram. To get "alert only when it matters, stay quiet otherwise," tell the
+  prompt to *output just `SKIP` when the condition isn't met*. This lets even frequent jobs (e.g.
+  every 5 minutes) run without spamming the chat.
 
 **Add jobs from the chat — in plain language:**
 

package/bot.mjs

@@ -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") {
@@ -100,6 +108,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 +140,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 +156,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 +187,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 +208,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 +216,7 @@ const COMMANDS = {
     { command: "new", description: "대화 맥락 초기화 (새 세션)" },
     { command: "cron", description: "예약 작업 보기·추가·삭제" },
     { command: "restart", description: "봇 재시작 (문법 검사 후)" },
+    { command: "status", description: "봇 상태·버전 보기" },
     { command: "id", description: "이 채팅 ID 확인" },
     { command: "help", description: "도움말" },
   ],
@@ -435,6 +463,15 @@ async function runScheduled(job) {
   const started = Date.now();
   try {
     const res = await runClaude(job.prompt, undefined); // 새 세션 (state 미저장)
+    // 조용한 예약 작업: 출력이 비었거나 정확히 "SKIP"이면 전송하지 않는다.
+    // (예: "조건 충족 시에만 알리고, 아니면 SKIP만 출력해" 식의 조건부 알림용)
+    if (res.ok) {
+      const body = (res.text || "").trim();
+      if (!body || /^skip$/i.test(body)) {
+        console.log(`Scheduled job suppressed (empty/SKIP): ${job.label || job.cron}`);
+        return;
+      }
+    }
     const secs = Math.round((Date.now() - started) / 1000);
     const label = job.label || job.cron;
     const footer = res.ok
@@ -618,6 +655,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.1",
+  "version": "0.2.3",
   "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": {