pinglet-cli 0.3.1 → 0.4.0

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/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/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.0",
   "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": {