pinglet-cli 0.3.1 → 0.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mabyko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -56,6 +56,12 @@ pinglet post "メッセージ"
 
 statusline の言語はシステム言語に応じて自動選択されます(韓国語/日本語、それ以外は英語)。言語で判定できない場合はタイムゾーン(ソウル/東京)で推定します。
 
+## 自動アップデート
+
+新しいバージョンが出ると、バックグラウンドで1日1回チェックして自動的に
+アップデートします(npm グローバルインストールのみ — pnpm/yarn は対象外)。
+無効にするには `~/.pinglet/config.json` に `"autoUpdate": false` を追加してください。
+
 ## コマンド
 
 | コマンド | 説明 |

package/README.ko.md

@@ -56,6 +56,12 @@ pinglet post "메시지"
 
 statusline 언어는 시스템 언어에 따라 자동 선택됩니다(한국어/일본어, 그 외는 영어). 시스템 언어로 판정이 안 되면 타임존(서울/도쿄)으로 추정합니다.
 
+## 자동 업데이트
+
+새 버전이 나오면 백그라운드에서 하루 1회 확인해 자동으로 업데이트합니다
+(npm 전역 설치일 때만 — pnpm/yarn 설치는 건드리지 않습니다).
+끄려면 `~/.pinglet/config.json`에 `"autoUpdate": false`를 추가하세요.
+
 ## 명령어
 
 | 명령 | 설명 |

package/README.md

@@ -56,6 +56,12 @@ The statusline shows how many terminals are coding alongside you right now:
 
 The statusline picks its language from your system language (Korean/Japanese, English otherwise), falling back to your timezone (Seoul/Tokyo) when the language doesn't decide it.
 
+## Auto-update
+
+Pinglet checks for a new version once a day in the background and updates
+itself automatically (only for npm global installs — pnpm/yarn installs are
+left untouched). To opt out, add `"autoUpdate": false` to `~/.pinglet/config.json`.
+
 ## Commands
 
 | Command | Description |

package/dist/adapters/claude.js

@@ -73,6 +73,11 @@ function detectClaude() {
 function statusLineCommand() {
     return `node "${(0, config_1.cliPath)()}" statusline`;
 }
+/**
+ * statusline 이벤트 트리거는 유휴 세션에서 멈추므로(새 메시지가 있어야 재실행),
+ * 유휴 pane이 옛 온라인 터미널 수를 계속 표시하지 않게 고정 주기(초)로도 재실행한다.
+ */
+const STATUSLINE_REFRESH_INTERVAL_S = 30;
 /** 예전 버전이 등록한 hook entry인지 식별 (command에 hook-prompt 포함 여부). */
 function isPingletHookEntry(entry) {
     return (entry.hooks?.some((h) => typeof h.command === "string" && h.command.includes("hook-prompt")) ?? false);
@@ -336,7 +341,11 @@ function installClaudeIntegration(config, options = {}) {
             ...(existing && !isOurs && { statusLineBackup: existing }),
         };
         (0, config_1.saveConfig)(config);
-        settings.statusLine = { type: "command", command: statusLineCommand() };
+        settings.statusLine = {
+            type: "command",
+            command: statusLineCommand(),
+            refreshInterval: STATUSLINE_REFRESH_INTERVAL_S,
+        };
         uninstallPromptHook(settings); // 구버전 hook 방식 흔적 정리
         // /pinglet 인라인 bash가 auto 모드 분류기에 막히지 않도록 allow 규칙 등록.
         // 경로가 바뀐(예: node 버전 업) 옛 규칙은 정리하고 현재 규칙 하나만 둔다.

package/dist/commands/refresh.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runRefresh = runRefresh;
 const config_1 = require("../config");
 const api_1 = require("../api");
+const update_1 = require("../update");
 const cache_1 = require("../cache");
 const claude_1 = require("../adapters/claude");
 /**
@@ -46,4 +47,6 @@ async function runRefresh() {
             (0, cache_1.saveState)(state);
         }
     }
+    // 하루 1회 새 버전 확인 후 npm 전역 설치면 백그라운드 자동 업데이트.
+    await (0, update_1.maybeSelfUpdate)(config);
 }

package/dist/commands/statusline.js

@@ -43,10 +43,11 @@ const queue_1 = require("../queue");
 const claude_1 = require("../adapters/claude");
 const runtime_1 = require("../runtime");
 /**
- * online 캐시 유효 기간 — refresh(≈5분) 3주기. 오프라인이 되면
- * 오래된 숫자를 "지금"이라고 보여주는 대신 표시를 접는다.
+ * online 캐시 유효 기간 — refresh(≈5분) 2주기. 서버의 온라인 판정 창
+ * (ONLINE_WINDOW_MS 10분)과 정렬해, 서버가 이미 오프라인으로 세는 시점에
+ * 클라이언트가 옛 숫자를 "지금"이라고 보여주지 않게 한다.
  */
-const ONLINE_STALE_MS = 15 * 60_000;
+const ONLINE_STALE_MS = 10 * 60_000;
 /** 신선한 online 캐시가 있을 때, 나를 제외한 켜진 터미널 수 (없거나 혼자면 null). */
 function onlineOthers(now) {
     const cache = (0, cache_1.loadOnline)();

package/dist/config.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_API_BASE_URL = exports.ONLINE_PATH = exports.POSTS_PATH = exports.EVENTS_PATH = exports.STATE_PATH = exports.FEED_PATH = exports.CONFIG_PATH = exports.PINGLET_DIR = exports.VERSION = void 0;
+exports.DEFAULT_API_BASE_URL = exports.UPDATE_PATH = exports.ONLINE_PATH = exports.POSTS_PATH = exports.EVENTS_PATH = exports.STATE_PATH = exports.FEED_PATH = exports.CONFIG_PATH = exports.PINGLET_DIR = exports.VERSION = void 0;
 exports.ensurePingletDir = ensurePingletDir;
 exports.readJsonFile = readJsonFile;
 exports.writeJsonFile = writeJsonFile;
@@ -62,6 +62,8 @@ exports.EVENTS_PATH = path.join(exports.PINGLET_DIR, "events.jsonl");
 exports.POSTS_PATH = path.join(exports.PINGLET_DIR, "posts.json");
 /** 지금 켜져 있는 터미널 수 캐시 — heartbeat 응답으로 갱신, statusline이 읽는다 */
 exports.ONLINE_PATH = path.join(exports.PINGLET_DIR, "online.json");
+/** 자동 업데이트 진행 기록 — refresh가 하루 1회 갱신 */
+exports.UPDATE_PATH = path.join(exports.PINGLET_DIR, "update.json");
 exports.DEFAULT_API_BASE_URL = process.env.PINGLET_API_URL ?? "https://pinglet.halluci.co.kr";
 function ensurePingletDir() {
     fs.mkdirSync(exports.PINGLET_DIR, { recursive: true });

package/dist/update.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNewerVersion = isNewerVersion;
+exports.maybeSelfUpdate = maybeSelfUpdate;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const REGISTRY_LATEST_URL = "https://registry.npmjs.org/pinglet-cli/latest";
+const CHECK_INTERVAL_MS = 24 * 3600_000; // 하루 1회 확인
+const RETRY_INTERVAL_MS = 7 * 24 * 3600_000; // 같은 버전 재시도는 주 1회
+/** Windows에서 npm은 npm.cmd라 shell 경유가 필요하다 (Node의 .cmd spawn 제한). */
+function npmSpawnOptions() {
+    return process.platform === "win32" ? { shell: true } : {};
+}
+async function fetchLatestVersion() {
+    try {
+        const res = await fetch(REGISTRY_LATEST_URL, {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        return typeof body.version === "string" ? body.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 단순 semver(major.minor.patch) 비교. 형식이 어긋나면 업데이트하지 않는 쪽으로 판정한다. */
+function isNewerVersion(latest, current) {
+    const parse = (v) => v.trim().split(".").map((n) => Number(n));
+    const a = parse(latest);
+    const b = parse(current);
+    if (a.length !== 3 || b.length !== 3)
+        return false;
+    if ([...a, ...b].some((n) => !Number.isInteger(n) || n < 0))
+        return false;
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i])
+            return a[i] > b[i];
+    }
+    return false;
+}
+/** npm 전역 루트. npm이 없거나 실패하면 null — 자동 업데이트를 포기한다. */
+function npmGlobalRoot() {
+    return new Promise((resolve) => {
+        (0, child_process_1.execFile)("npm", ["root", "-g"], { timeout: 10_000, windowsHide: true, ...npmSpawnOptions() }, (err, stdout) => resolve(err ? null : stdout.trim() || null));
+    });
+}
+/**
+ * 새 버전이 있으면 백그라운드로 자기 자신을 업데이트한다.
+ * - npm 전역 설치일 때만 실행한다 (cliPath가 `npm root -g` 아래인지 확인).
+ *   pnpm/yarn/링크 설치에 npm을 덧씌우면 다른 복사본만 생기고 적용도 안 된다.
+ * - statusline은 매 틱 새 프로세스로 뜨므로, 설치가 끝나면 다음 틱부터
+ *   새 버전이 실행된다. 전역 경로는 버전과 무관해 설정 변경도 필요 없다.
+ * - 실패해도 조용히 넘어간다 (렌더링·refresh에 영향 금지). 재시도는 주 1회.
+ */
+async function maybeSelfUpdate(config) {
+    if (config.autoUpdate === false)
+        return;
+    const now = Date.now();
+    const state = (0, config_1.readJsonFile)(config_1.UPDATE_PATH) ?? {};
+    const lastCheck = state.lastCheckAt ? Date.parse(state.lastCheckAt) : NaN;
+    if (!Number.isNaN(lastCheck) && now - lastCheck < CHECK_INTERVAL_MS)
+        return;
+    // 확인 시각을 먼저 기록 — 레지스트리 장애 시에도 하루 1회 이상 두드리지 않는다.
+    state.lastCheckAt = new Date(now).toISOString();
+    (0, config_1.writeJsonFile)(config_1.UPDATE_PATH, state);
+    const latest = await fetchLatestVersion();
+    if (!latest || !isNewerVersion(latest, config_1.VERSION))
+        return;
+    if (state.lastAttempt?.version === latest) {
+        const at = Date.parse(state.lastAttempt.at);
+        if (!Number.isNaN(at) && now - at < RETRY_INTERVAL_MS)
+            return;
+    }
+    const root = await npmGlobalRoot();
+    if (!root || !(0, config_1.cliPath)().startsWith(root + path.sep))
+        return;
+    state.lastAttempt = { version: latest, at: new Date(now).toISOString() };
+    (0, config_1.writeJsonFile)(config_1.UPDATE_PATH, state);
+    try {
+        const child = (0, child_process_1.spawn)("npm", ["install", "-g", `pinglet-cli@${latest}`], { detached: true, stdio: "ignore", windowsHide: true, ...npmSpawnOptions() });
+        child.unref();
+    }
+    catch {
+        // npm 실행 실패 — 다음 주기에 재시도된다.
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pinglet-cli",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Short messages from other developers shown in your Claude Code spinner while the AI thinks — zero tokens, never reads your code. Claude Code / Codex integration",
   "license": "MIT",
   "repository": {