tokenphage 2026.7.1-BETA → 2026.7.2-BETA

package/README.md

@@ -54,7 +54,7 @@ npm install -g tokenphage@latest
 
 ### ⬆️ 업데이트
 
-CLI를 실행하면(대시보드를 열거나 `sync` 할 때) 새 버전이 있는지 확인합니다. 매번 조회하지는 않고, 과도한 요청을 막기 위해 **최대 하루 한 번**만 npm에 물어봅니다(24시간 캐시). 새 버전이 확인되면 대시보드 맨 위에 안내 배너가 뜨고, 메뉴에 **⬆ Update to …** 항목이 추가됩니다. 이 항목을 고르면 최신 버전이 자동으로 설치됩니다(전역 설치가 아니면 정확한 수동 명령을 안내).
+대시보드를 열면 새 버전이 있는지 확인합니다. 새 버전이 확인되면 대시보드 맨 위에 안내 배너가 뜨고, 메뉴에 **⬆ Update to …** 항목이 추가됩니다. 이 항목을 고르면 최신 버전이 자동으로 설치됩니다(전역 설치가 아니면 정확한 수동 명령을 안내).
 
 직접 올리고 싶다면 언제든 아래 명령을 실행하면 됩니다.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenphage",
-  "version": "2026.7.1-BETA",
+  "version": "2026.7.2-BETA",
   "description": "AI 토큰 사용량 GitHub README 뱃지",
   "author": "kobenlys <kobenlys@gmail.com>",
   "license": "MIT",

package/src/auth.js

@@ -93,17 +93,6 @@ export function clearLastSyncDate() {
   saveConfig(rest);
 }
 
-/** 업데이트 캐시(npm 최신버전·마지막 조회시각)를 반환한다. 없으면 각각 null. */
-export function getUpdateCache() {
-  const cfg = loadConfig();
-  return { latestVersion: cfg.latestVersion ?? null, lastUpdateCheck: cfg.lastUpdateCheck ?? null };
-}
-
-/** npm 최신버전과 조회시각(ISO)을 다른 설정을 보존한 채 갱신 저장한다. */
-export function saveUpdateCache(latestVersion, lastUpdateCheck) {
-  saveConfig({ ...loadConfig(), latestVersion, lastUpdateCheck });
-}
-
 // Gist 소유권 검증용 파일명 — 사용자가 이 이름으로 Gist를 만들어야 한다.
 export const VERIFICATION_FILE = 'tokenphage.txt';
 

package/src/index.js

@@ -14,7 +14,7 @@ import { accent } from './gradient.js';
 import { localDateOf } from './lib/dates.js';
 import { claudeDirCandidates } from './parser.js';
 import { checkClaudeRetention, applyRetentionSetting, DEFAULT_CLEANUP_DAYS } from './lib/retention.js';
-import { refreshCache, getUpdateInfo } from './lib/update-check.js';
+import { checkLatestVersion, getUpdateInfo } from './lib/update-check.js';
 import { runUpdate } from './lib/updater.js';
 import { confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
@@ -149,10 +149,6 @@ async function runSync() {
   await syncRecords(API_BASE, token, deviceId, records);
   saveLastSyncDate(today);
   console.log('Done! Badge will update shortly.');
-
-  // 이미 네트워크를 쓰는 지점이므로 여기서 npm 최신버전 캐시를 갱신한다(TTL 게이트 내장, 실패 무해).
-  // 04:00 자동 sync가 이 경로로 캐시를 채워, 다음 대시보드 진입 시 업데이트 배너가 뜬다.
-  await refreshCache(Date.now());
 }
 
 /**
@@ -245,12 +241,12 @@ program.action(async () => {
 
     // 인증 이후 메뉴는 최신 설정이 필요하므로 여기서 동적 import (상단 정적 import과 별개)
     const { loadConfig } = await import('./auth.js');
-    // 업데이트 캐시를 백그라운드로 갱신한다(await 안 함 → startup 지연 0). 결과는 다음 렌더에 반영된다.
-    refreshCache(Date.now()).catch(() => {});
+    // TUI 진입 시 npm 최신버전을 1회 조회(짧은 타임아웃). 세션 동안 재사용해 배너/메뉴에 반영한다.
+    const latest = await checkLatestVersion();
     // 대시보드 루프: 액션 수행 후 메인으로 복귀, Exit/Esc 에서만 종료
     while (true) {
       const cfg = loadConfig();
-      const action = await promptDashboard(cfg);
+      const action = await promptDashboard(cfg, latest);
       if (action === 'exit') break;
       if (action === 'sync') await runSync();
       else if (action === 'install-hook') await runInstallHook();
@@ -258,7 +254,7 @@ program.action(async () => {
       else if (action === 'advanced') await runAdvanced(API_BASE, cfg);
       else if (action === 'update') {
         // 업데이트 성공 시 현재 프로세스는 여전히 구버전 코드 → 재실행 안내 후 종료.
-        const { hasUpdate, latest } = getUpdateInfo(version, cfg);
+        const { hasUpdate } = getUpdateInfo(version, latest);
         if (hasUpdate) {
           const result = await runUpdate(latest);
           await pauseForEnter();

package/src/lib/config-schema.js

@@ -84,9 +84,7 @@ export function normalizeConfig(raw, today) {
   dropIf('deviceId', isUuid);                         // 없으면 getOrCreateDeviceId가 재발급
   dropIf('lastSyncDate', (v) => isYmdDate(v, today)); // 없으면 전체 재파싱
   dropIf('hookInstalledAt', isIsoDate);
-  dropIf('lastUpdateCheck', isIsoDate);
   dropIf('hookInstalled', (v) => typeof v === 'boolean');
-  dropIf('latestVersion', (v) => typeof v === 'string');
   dropIf('claudePaths', isStringArray);
   dropIf('hookMeta', (v) => v != null && typeof v === 'object' && !Array.isArray(v));
 

package/src/lib/update-check.js

@@ -1,53 +1,19 @@
 /**
- * CLI 업데이트 검사: npm 레지스트리에서 최신버전을 조회해 config.json에 캐시하고,
- * 현재 버전과 비교해 업데이트 여부를 판정한다.
+ * CLI 업데이트 검사: TUI(대시보드) 진입 시 npm 레지스트리에서 latest를 1회 조회하고,
+ * 현재 버전과 문자열이 다르면 업데이트가 있다고 판정한다.
  *
  * 설계 원칙
- *  - 화면(메인 대시보드)은 캐시(getUpdateInfo)만 읽어 즉시 렌더 → startup 지연 0.
- *  - 네트워크 조회(refreshCache)는 백그라운드/sync 시점에 돌아 캐시를 채우고, 결과는 "다음 렌더"에 반영된다.
- *  - 어떤 실패(네트워크·404·파싱·옵트아웃)도 조용히 흘려보내 본 기능(대시보드)을 절대 막지 않는다.
+ *  - update 제안은 대화형 TUI에서만 뜬다. 비대화형(sync·스크립트)은 대상 아님 → 캐시/TTL 불필요.
+ *  - checkLatestVersion()을 TUI 진입 시 1회 await로 호출(짧은 타임아웃), 결과를 세션 메모리에 담아 배너 판정에 쓴다.
+ *  - 어떤 실패(네트워크·404·파싱·옵트아웃)도 조용히 null로 흘려보내 대시보드를 절대 막지 않는다.
  */
-import { loadConfig, saveUpdateCache } from '../auth.js';
 
 // 배포 패키지명 — 레지스트리 URL과 `npm i -g` 대상에서 공유한다.
 export const PACKAGE_NAME = 'tokenphage';
 // npm 레지스트리 latest 매니페스트(공개·무인증). { "version": "", ... } 반환, 미배포면 404.
 export const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
 
-const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24h TTL — 하루 1회만 조회
-const FETCH_TIMEOUT_MS = 2500;                 // 레지스트리 지연이 sync를 끌지 않도록 상한
-
-/**
- * CalVer "YYYY.M.PATCH" 두 버전을 숫자 3파트로 비교한다.
- * @returns {-1|0|1} a<b → -1, a==b → 0, a>b → 1. 어느 한쪽이라도 비숫자(dev 등)면 0(=차이 없음)으로 안전 폴백.
- */
-export function compareVersion(a, b) {
-  const pa = String(a).split('.').map(Number);
-  const pb = String(b).split('.').map(Number);
-  // CalVer는 정확히 3파트여야 한다. 형식이 어긋나면(2파트/4파트/dev 등) 비교 불가로 보고 0(=업데이트 없음) 폴백.
-  if (pa.length !== 3 || pb.length !== 3) return 0;
-  for (let i = 0; i < 3; i++) {
-    const x = pa[i];
-    const y = pb[i];
-    if (Number.isNaN(x) || Number.isNaN(y)) return 0; // 비CalVer → 비교 불가 → 업데이트 없음
-    if (x > y) return 1;
-    if (x < y) return -1;
-  }
-  return 0;
-}
-
-/**
- * 마지막 조회 이후 TTL(24h)이 지났는지 판정한다. now는 인자로 주입해 테스트 결정성을 확보한다.
- * @param {string|null} lastUpdateCheck 마지막 조회 ISO 시각 (없으면 null)
- * @param {number} now 현재 epoch ms
- * @returns {boolean} 조회가 필요하면 true
- */
-export function shouldCheck(lastUpdateCheck, now) {
-  if (!lastUpdateCheck) return true;
-  const last = Date.parse(lastUpdateCheck);
-  if (Number.isNaN(last)) return true; // 손상된 시각 → 재조회
-  return now - last >= CHECK_INTERVAL_MS;
-}
+const FETCH_TIMEOUT_MS = 1500; // TUI 진입 조회 상한 — 오프라인/지연 시 이 시간 후 배너 없이 진행
 
 /** 업데이트 알림을 끄는 환경인지. 옵트아웃 env 또는 dev(TOKENPHAGE_API 세팅)면 조회·표시 모두 스킵. */
 export function isUpdateNotifierDisabled() {
@@ -55,23 +21,27 @@ export function isUpdateNotifierDisabled() {
 }
 
 /**
- * 캐시(cfg.latestVersion)와 현재 버전을 비교해 업데이트 정보를 반환한다. 네트워크를 쓰지 않는 동기 함수.
+ * 조회한 latest와 현재 버전을 비교해 업데이트 정보를 반환한다. 순수 함수(네트워크·env·캐시 없음).
+ * update 액션은 항상 `@latest`를 설치하므로 "설치본 ≠ latest"가 곧 "업데이트하면 바뀜"과 일치한다.
+ * 프리릴리스 접미사(-BETA)도 파싱 없이 문자열 비교라 안전하다.
  * @param {string} currentVersion 현재 설치 버전(package.json)
- * @param {object} cfg loadConfig() 결과(또는 동등한 객체)
+ * @param {string|null|undefined} latest checkLatestVersion() 결과(조회 실패/옵트아웃 시 null)
  * @returns {{hasUpdate:boolean, latest?:string, current?:string}}
  */
-export function getUpdateInfo(currentVersion, cfg) {
-  if (isUpdateNotifierDisabled()) return { hasUpdate: false };
-  const latest = cfg?.latestVersion;
-  if (!latest) return { hasUpdate: false };
-  if (compareVersion(latest, currentVersion) > 0) {
+export function getUpdateInfo(currentVersion, latest) {
+  if (latest && latest !== currentVersion) {
     return { hasUpdate: true, latest, current: currentVersion };
   }
   return { hasUpdate: false };
 }
 
-/** npm 레지스트리에서 latest 버전 문자열을 조회한다. 실패(타임아웃·404·파싱)는 모두 null. */
-async function fetchLatestFromNpm() {
+/**
+ * npm 레지스트리에서 latest 버전 문자열을 1회 조회한다. TUI 진입 시 한 번 await로 호출해 세션 동안 재사용한다.
+ * 옵트아웃/실패(타임아웃·404·파싱)는 모두 null — 절대 throw하지 않는다.
+ * @returns {Promise<string|null>}
+ */
+export async function checkLatestVersion() {
+  if (isUpdateNotifierDisabled()) return null; // 옵트아웃/dev → 조회 스킵
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
   try {
@@ -85,20 +55,3 @@ async function fetchLatestFromNpm() {
     clearTimeout(timer);
   }
 }
-
-/**
- * TTL이 지났으면 npm 최신버전을 조회해 config 캐시를 갱신한다. 절대 throw하지 않는다.
- * @param {number} now 현재 epoch ms (Date.now()를 주입)
- */
-export async function refreshCache(now) {
-  try {
-    if (isUpdateNotifierDisabled()) return;
-    const cfg = loadConfig();
-    if (!shouldCheck(cfg.lastUpdateCheck, now)) return;
-    const latest = await fetchLatestFromNpm();
-    if (!latest) return;
-    saveUpdateCache(latest, new Date(now).toISOString());
-  } catch {
-    // 캐시 갱신 실패는 무해 — 다음 기회에 재시도한다.
-  }
-}

package/src/ui.js

@@ -127,14 +127,15 @@ export async function promptFirstRun() {
 
 /**
  * 인증된 사용자를 위한 대시보드 메뉴.
- * @param {{ token: string, lastSyncDate: string|null, hookInstalled: boolean, hookMeta: object|null, latestVersion?: string }} cfg
+ * @param {{ token: string, lastSyncDate: string|null, hookInstalled: boolean, hookMeta: object|null }} cfg
+ * @param {string|null} latest TUI 진입 시 조회한 npm 최신버전(조회 실패/옵트아웃 시 null)
  * @returns {'update' | 'sync' | 'install-hook' | 'uninstall-hook' | 'advanced' | 'exit'}
  */
-export async function promptDashboard(cfg) {
+export async function promptDashboard(cfg, latest) {
   printWelcome();
 
-  // 캐시된 npm 최신버전과 현재 버전을 비교해, 새 버전이 있을 때만 민트 배너를 출력한다(네트워크 X).
-  const update = getUpdateInfo(version, cfg);
+  // TUI 진입 시 조회한 npm 최신버전과 현재 버전을 비교해, 다를 때만 민트 배너를 출력한다.
+  const update = getUpdateInfo(version, latest);
   if (update.hasUpdate) {
     const bar = accent('  ┃ ');
     console.log(bar + accent(`⬆  Update available  v${update.current} → v${update.latest}`));