@athsra/cli 1.1.7 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@athsra/cli",
-  "version": "1.1.7",
+  "version": "1.2.0",
   "description": "athsra CLI — E2EE secret manager on Cloudflare edge. Doppler-style dev UX + zero-knowledge encryption + soft-delete + version history. MIT.",
   "type": "module",
   "main": "./src/index.ts",

package/src/index.ts

@@ -29,6 +29,7 @@ import { serviceTokenCmd } from './commands/service-token.ts';
 import { setCmd } from './commands/set.ts';
 import { unsetCmd } from './commands/unset.ts';
 import { versionsCmd } from './commands/versions.ts';
+import { notifyIfOutdated } from './lib/update-check.ts';
 
 // package.json 단일 출처 — 하드코딩 desync 방지(1.1.3 이후 bump 누락으로 --version 이 stale 했던 버그 근본 수정).
 const VERSION = pkg.version;
@@ -186,7 +187,15 @@ function levenshtein(a: string, b: string): number {
   return prev[n] ?? 0;
 }
 
-handler(args.slice(1))
+// 대화형 명령(login/doctor)에서 stale 글로벌 경고 — 비차단(캐시 기반)·opt-out(ATHSRA_NO_UPDATE_CHECK/CI).
+// login 은 ecosystem 2026-06-21 피드백의 버그 진입점: stale CLI(v1.0.0)가 이미 수정된 SSO 버그를 재현.
+const nudge =
+  cmd === 'login' || cmd === 'doctor'
+    ? notifyIfOutdated(VERSION).catch(() => {})
+    : Promise.resolve();
+
+nudge
+  .then(() => handler(args.slice(1)))
   .then((code) => process.exit(code))
   .catch((err: Error) => {
     console.error(`error: ${err.message}`);

package/src/lib/update-check.ts

@@ -0,0 +1,95 @@
+/**
+ * 버전 staleness nudge — 글로벌 설치가 npm latest 보다 낡으면 경고.
+ *
+ * 동기: stale 글로벌(v1.0.0)이 이미 수정된 SSO 버그(discovery `/sso` prefix · WSL xdg-open 크래시)를
+ * 재현해 agent-driven 로그인을 막던 것 (ecosystem 2026-06-21 피드백). canon agent-auth-ux 가 athsra 를
+ * agent-driven 인증 레퍼런스로 규정하므로, stale 설치가 깨진 인증을 조용히 서빙하지 않게 신호한다.
+ *
+ * 비차단: 경고는 캐시 기반(무네트워크·즉시), 갱신은 1일 1회 ≤2s timeout — 대화형 명령(login/doctor)에서만 호출.
+ * 우회: ATHSRA_NO_UPDATE_CHECK / CI. 어떤 실패(네트워크·파싱·fs)에도 조용히 no-op.
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { configDir, ensureConfigDir } from './config.ts';
+
+const REGISTRY = 'https://registry.npmjs.org/@athsra/cli/latest';
+const DAY_MS = 24 * 60 * 60 * 1000;
+const TIMEOUT_MS = 2000;
+
+interface UpdateCache {
+  latest?: string;
+  checkedAt?: number;
+}
+
+function cacheFile(): string {
+  return join(configDir(), 'update-check.json');
+}
+
+function readCache(): UpdateCache {
+  try {
+    return JSON.parse(readFileSync(cacheFile(), 'utf8')) as UpdateCache;
+  } catch {
+    return {};
+  }
+}
+
+function writeCache(c: UpdateCache): void {
+  try {
+    ensureConfigDir();
+    writeFileSync(cacheFile(), JSON.stringify(c));
+  } catch {
+    /* 캐시 못 써도 무해 — 다음 실행에 재시도 */
+  }
+}
+
+/** semver x.y.z 비교 — a 가 b 보다 높으면 true. 비표준/pre-release 는 보수적으로 false. */
+export function isNewer(a: string, b: string): boolean {
+  const pa = a.split('.').map((n) => Number.parseInt(n, 10));
+  const pb = b.split('.').map((n) => Number.parseInt(n, 10));
+  for (let i = 0; i < 3; i++) {
+    const x = pa[i] ?? 0;
+    const y = pb[i] ?? 0;
+    if (Number.isNaN(x) || Number.isNaN(y)) return false;
+    if (x !== y) return x > y;
+  }
+  return false;
+}
+
+async function fetchLatest(): Promise<string | null> {
+  try {
+    const res = await fetch(REGISTRY, {
+      headers: { accept: 'application/json' },
+      signal: AbortSignal.timeout(TIMEOUT_MS),
+    });
+    if (!res.ok) return null;
+    const doc: unknown = await res.json();
+    if (doc && typeof doc === 'object' && 'version' in doc) {
+      const v = (doc as { version: unknown }).version;
+      return typeof v === 'string' ? v : null;
+    }
+  } catch {
+    /* offline / timeout / parse → null (조용) */
+  }
+  return null;
+}
+
+/**
+ * 현재 버전이 npm latest 보다 낡으면 stderr 경고. 대화형 명령(login/doctor)에서 호출.
+ * 캐시된 latest 로 즉시 판단 + 1일 경과 시 갱신(≤2s). 실패·opt-out 시 조용히 no-op.
+ */
+export async function notifyIfOutdated(current: string): Promise<void> {
+  if (process.env.ATHSRA_NO_UPDATE_CHECK || process.env.CI) return;
+  let cache = readCache();
+  if (!cache.checkedAt || Date.now() - cache.checkedAt > DAY_MS) {
+    const latest = await fetchLatest();
+    // 갱신 실패 시에도 checkedAt 만 올려 매 실행 네트워크 재시도 방지 (직전 캐시 latest 유지).
+    cache = latest ? { latest, checkedAt: Date.now() } : { ...cache, checkedAt: Date.now() };
+    writeCache(cache);
+  }
+  if (cache.latest && isNewer(cache.latest, current)) {
+    process.stderr.write(
+      `\n  ⚠ @athsra/cli ${cache.latest} 사용 가능 (현재 ${current}). ` +
+        `업그레이드: npm i -g @athsra/cli@latest  (bun: bun add -g @athsra/cli@latest)\n\n`,
+    );
+  }
+}