pinglet-cli 0.1.6 → 0.2.1

package/README.md

@@ -41,7 +41,7 @@ codex    # turn 완료 시 macOS 알림으로 Ping 전달 (experimental)
 | `pinglet install [--api <url>] [--force]` | Claude Code / Codex 자동 감지 후 integration 설치 + 서버 등록 + 초기 feed 캐시 |
 | `pinglet uninstall [--purge]` | integration 제거, 기존 설정 복원. `--purge`는 `~/.pinglet`까지 삭제 |
 | `pinglet login [--token <jwt>]` | GitHub 로그인 후 익명 설치를 계정에 연결 |
-| `pinglet post "메시지" [--category <c>]` | 메시지 작성 (설치만 해도 익명 작성 가능, 로그인 시 닉네임 표시) |
+| `pinglet post "메시지" [--category <c>]` | 메시지 작성 (GitHub 로그인 필요, 읽기는 로그인 없이 가능) |
 | `pinglet doctor` | 설치/캐시/큐/서버 상태 진단 |
 | `pinglet ping` | 메시지 미리보기 (이벤트 기록 없음) |
 
@@ -114,3 +114,14 @@ install 시 `~/.claude/commands/pinglet.md` slash command가 함께 설치되며
   state.json     # 현재 표시 중 메시지, seen 카운트, flush/refresh 타이밍
   events.jsonl   # Local Event Queue (append-only)
 ```
+
+## 약관 및 개인정보처리방침
+
+Pinglet은 GitHub 계정 정보(로그인 시), 설치 환경 정보, 접속 IP를 서비스 제공·어뷰징
+방지 목적으로 처리합니다. 로그인하여 메시지를 작성하면 아래 문서에 동의한 것으로
+간주됩니다.
+
+- [이용약관](https://pinglet.halluci.co.kr/terms)
+- [개인정보처리방침](https://pinglet.halluci.co.kr/privacy)
+
+문의: leeyeonggyun@naver.com

package/dist/adapters/claude.js

@@ -131,19 +131,42 @@ const MAX_VERBS = 30;
 /** spinner 한 줄에 "(27s · ↓ 1.0k tokens)" 등이 뒤에 붙으므로 여유를 둔다. */
 const MAX_VERB_LEN = 60;
 function readSettings() {
+    return readSettingsWithMtime().settings;
+}
+function settingsMtimeMs() {
+    try {
+        return fs.statSync(SETTINGS_PATH).mtimeMs;
+    }
+    catch {
+        return null; // 파일 없음
+    }
+}
+function readSettingsWithMtime() {
+    const mtimeMs = settingsMtimeMs();
     try {
-        return JSON.parse(fs.readFileSync(SETTINGS_PATH, "utf8"));
+        return {
+            settings: JSON.parse(fs.readFileSync(SETTINGS_PATH, "utf8")),
+            mtimeMs,
+        };
     }
     catch {
-        return {};
+        return { settings: {}, mtimeMs };
     }
 }
-function writeSettings(settings) {
+/**
+ * mtime이 읽던 시점 그대로일 때만 쓴다 — 변경이 감지되면 false를 돌려주고
+ * 호출부가 다시 읽어 재적용한다. Claude Code 자신도 이 파일을 쓰기 때문에,
+ * 그 사이의 변경을 우리 스냅샷으로 덮어써 사용자 설정을 유실하면 안 된다.
+ */
+function writeSettings(settings, expectedMtimeMs) {
     fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+    if (settingsMtimeMs() !== expectedMtimeMs)
+        return false;
     // settings.json은 Claude Code가 수시로 읽는 파일이라 tmp+rename으로 원자적으로 쓴다.
     const tmp = SETTINGS_PATH + ".pinglet-tmp";
     fs.writeFileSync(tmp, JSON.stringify(settings, null, 2) + "\n");
     fs.renameSync(tmp, SETTINGS_PATH);
+    return true;
 }
 function isPingletTip(tip) {
     return tip.startsWith(PINGLET_TIP_MARKER);
@@ -194,47 +217,58 @@ function armSpinnerMessage(config, message) {
     const adapter = config.adapters.claude;
     if (!adapter)
         return false;
-    const settings = readSettings();
-    cleanupSpinnerTips(settings, config);
-    const existing = settings.spinnerVerbs;
-    const existingVerbs = existing?.verbs ?? [];
-    // 사용자가 원래 갖고 있던 spinnerVerbs는 최초 1회 백업해 두고 uninstall 시 복원한다.
-    const isOurs = existingVerbs.some(isPingletTip);
-    if (existing && !isOurs && adapter.spinnerVerbsBackup === undefined) {
-        adapter.spinnerVerbsBackup = existing;
-        (0, config_1.saveConfig)(config);
-    }
-    const userVerbs = existingVerbs.filter((verb) => !isPingletTip(verb));
-    const pingletVerbs = message ? buildPingletVerbs([message]) : [];
-    // armed할 메시지가 없으면 spinner를 기본 상태로 되돌린다.
-    if (pingletVerbs.length === 0) {
-        if (!isOurs)
-            return false;
-        const backup = adapter.spinnerVerbsBackup;
-        if (backup) {
-            settings.spinnerVerbs = backup;
-            delete adapter.spinnerVerbsBackup;
+    // 읽기~쓰기 사이에 다른 프로세스(Claude Code 등)가 파일을 바꿨으면
+    // writeSettings가 거부하므로, 다시 읽어 재적용한다.
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const { settings, mtimeMs } = readSettingsWithMtime();
+        cleanupSpinnerTips(settings, config);
+        const existing = settings.spinnerVerbs;
+        const existingVerbs = existing?.verbs ?? [];
+        // 사용자가 원래 갖고 있던 spinnerVerbs는 최초 1회 백업해 두고 uninstall 시 복원한다.
+        const isOurs = existingVerbs.some(isPingletTip);
+        if (existing && !isOurs && adapter.spinnerVerbsBackup === undefined) {
+            adapter.spinnerVerbsBackup = existing;
             (0, config_1.saveConfig)(config);
         }
-        else if (userVerbs.length > 0) {
-            settings.spinnerVerbs = { ...existing, verbs: userVerbs };
+        const userVerbs = existingVerbs.filter((verb) => !isPingletTip(verb));
+        const pingletVerbs = message ? buildPingletVerbs([message]) : [];
+        // armed할 메시지가 없으면 spinner를 기본 상태로 되돌린다.
+        if (pingletVerbs.length === 0) {
+            if (!isOurs)
+                return false;
+            const backup = adapter.spinnerVerbsBackup;
+            if (backup) {
+                settings.spinnerVerbs = backup;
+            }
+            else if (userVerbs.length > 0) {
+                settings.spinnerVerbs = { ...existing, verbs: userVerbs };
+            }
+            else {
+                delete settings.spinnerVerbs;
+            }
+            if (writeSettings(settings, mtimeMs)) {
+                // 쓰기가 확정된 뒤에만 백업을 소비한다 (실패 시 백업 유실 방지).
+                if (backup) {
+                    delete adapter.spinnerVerbsBackup;
+                    (0, config_1.saveConfig)(config);
+                }
+                return false;
+            }
+            continue;
         }
-        else {
-            delete settings.spinnerVerbs;
+        const next = [...userVerbs, ...pingletVerbs];
+        // 같은 메시지를 다시 armed하는 경우 파일 쓰기를 생략한다 (300ms 렌더링 경로 보호).
+        if (existing?.mode === "replace" &&
+            existingVerbs.length === next.length &&
+            existingVerbs.every((v, i) => v === next[i])) {
+            return true;
         }
-        writeSettings(settings);
-        return false;
-    }
-    const next = [...userVerbs, ...pingletVerbs];
-    // 같은 메시지를 다시 armed하는 경우 파일 쓰기를 생략한다 (300ms 렌더링 경로 보호).
-    if (existing?.mode === "replace" &&
-        existingVerbs.length === next.length &&
-        existingVerbs.every((v, i) => v === next[i])) {
-        return true;
+        settings.spinnerVerbs = { mode: "replace", verbs: next };
+        if (writeSettings(settings, mtimeMs))
+            return true;
     }
-    settings.spinnerVerbs = { mode: "replace", verbs: next };
-    writeSettings(settings);
-    return true;
+    // 계속 충돌하면 이번 tick은 건너뛴다 — 다음 statusline tick에서 재시도된다.
+    return false;
 }
 /** doctor용: spinner verb로 등록된 Pinglet 메시지 개수. */
 function spinnerVerbsStatus() {
@@ -247,75 +281,84 @@ function isClaudeIntegrationInstalled() {
     return settings.statusLine?.command?.includes("pinglet") ?? false;
 }
 function installClaudeIntegration(config, options = {}) {
-    const settings = readSettings();
-    const existing = settings.statusLine;
-    const isOurs = existing?.command?.includes("pinglet");
-    if (existing && !isOurs && !options.force) {
-        return {
-            ok: false,
-            reason: "기존 statusLine 설정이 있습니다. 덮어쓰려면 --force로 다시 실행하세요.",
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const { settings, mtimeMs } = readSettingsWithMtime();
+        const existing = settings.statusLine;
+        const isOurs = existing?.command?.includes("pinglet");
+        if (existing && !isOurs && !options.force) {
+            return {
+                ok: false,
+                reason: "기존 statusLine 설정이 있습니다. 덮어쓰려면 --force로 다시 실행하세요.",
+            };
+        }
+        config.adapters.claude = {
+            // 재설치 시 기존 백업(spinnerVerbsBackup 등)이 날아가지 않게 유지한다.
+            ...config.adapters.claude,
+            installedAt: new Date().toISOString(),
+            settingsPath: SETTINGS_PATH,
+            // 사용자의 기존 설정은 백업해 두고 uninstall 시 복원한다.
+            ...(existing && !isOurs && { statusLineBackup: existing }),
         };
+        (0, config_1.saveConfig)(config);
+        settings.statusLine = { type: "command", command: statusLineCommand() };
+        uninstallPromptHook(settings); // 구버전 hook 방식 흔적 정리
+        if (!writeSettings(settings, mtimeMs))
+            continue; // 다른 프로세스와 충돌 → 재읽기
+        installSlashCommand();
+        // spinner verb는 로컬 캐시에 실제 feed가 있을 때만 채운다. 없으면 기본 spinner 유지.
+        armSpinnerMessage(config, (0, cache_1.loadFeedMessages)()[0] ?? null);
+        return { ok: true };
     }
-    config.adapters.claude = {
-        // 재설치 시 기존 백업(spinnerVerbsBackup 등)이 날아가지 않게 유지한다.
-        ...config.adapters.claude,
-        installedAt: new Date().toISOString(),
-        settingsPath: SETTINGS_PATH,
-        // 사용자의 기존 설정은 백업해 두고 uninstall 시 복원한다.
-        ...(existing && !isOurs && { statusLineBackup: existing }),
+    return {
+        ok: false,
+        reason: "settings.json이 계속 변경되고 있어 설치하지 못했습니다. 잠시 후 다시 시도하세요.",
     };
-    (0, config_1.saveConfig)(config);
-    settings.statusLine = { type: "command", command: statusLineCommand() };
-    uninstallPromptHook(settings); // 구버전 hook 방식 흔적 정리
-    writeSettings(settings);
-    installSlashCommand();
-    // spinner verb는 로컬 캐시에 실제 feed가 있을 때만 채운다. 없으면 기본 spinner 유지.
-    armSpinnerMessage(config, (0, cache_1.loadFeedMessages)()[0] ?? null);
-    return { ok: true };
 }
 function uninstallClaudeIntegration(config) {
-    const settings = readSettings();
-    let changed = false;
-    if (settings.statusLine?.command?.includes("pinglet")) {
-        const backup = config.adapters.claude?.statusLineBackup;
-        if (backup) {
-            settings.statusLine = backup;
+    let settingsChanged = false;
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const { settings, mtimeMs } = readSettingsWithMtime();
+        settingsChanged = false;
+        if (settings.statusLine?.command?.includes("pinglet")) {
+            const backup = config.adapters.claude?.statusLineBackup;
+            if (backup) {
+                settings.statusLine = backup;
+            }
+            else {
+                delete settings.statusLine;
+            }
+            settingsChanged = true;
         }
-        else {
-            delete settings.statusLine;
+        if (cleanupSpinnerTips(settings, config)) {
+            settingsChanged = true;
         }
-        changed = true;
-    }
-    if (cleanupSpinnerTips(settings, config)) {
-        changed = true;
-    }
-    if (uninstallPromptHook(settings)) {
-        changed = true;
-    }
-    if (uninstallSlashCommand()) {
-        changed = true;
-    }
-    const verbs = settings.spinnerVerbs;
-    if (verbs?.verbs?.some(isPingletTip)) {
-        const verbsBackup = config.adapters.claude?.spinnerVerbsBackup;
-        const userVerbs = verbs.verbs.filter((verb) => !isPingletTip(verb));
-        if (verbsBackup) {
-            settings.spinnerVerbs = verbsBackup;
-        }
-        else if (userVerbs.length > 0) {
-            settings.spinnerVerbs = { ...verbs, verbs: userVerbs };
+        if (uninstallPromptHook(settings)) {
+            settingsChanged = true;
         }
-        else {
-            delete settings.spinnerVerbs;
+        const verbs = settings.spinnerVerbs;
+        if (verbs?.verbs?.some(isPingletTip)) {
+            const verbsBackup = config.adapters.claude?.spinnerVerbsBackup;
+            const userVerbs = verbs.verbs.filter((verb) => !isPingletTip(verb));
+            if (verbsBackup) {
+                settings.spinnerVerbs = verbsBackup;
+            }
+            else if (userVerbs.length > 0) {
+                settings.spinnerVerbs = { ...verbs, verbs: userVerbs };
+            }
+            else {
+                delete settings.spinnerVerbs;
+            }
+            settingsChanged = true;
         }
-        changed = true;
-    }
-    if (changed) {
-        writeSettings(settings);
+        if (!settingsChanged)
+            break;
+        if (writeSettings(settings, mtimeMs))
+            break; // 충돌 시 재읽기 후 재적용
     }
+    const commandRemoved = uninstallSlashCommand();
     if (config.adapters.claude) {
         delete config.adapters.claude;
         (0, config_1.saveConfig)(config);
     }
-    return changed;
+    return settingsChanged || commandRemoved;
 }

package/dist/api.js

@@ -140,12 +140,12 @@ async function fetchMessageStats(config, messageId) {
 }
 /**
  * POST /messages — 메시지 작성 (분당 5개 제한).
- * 로그인했으면 유저 토큰으로(닉네임 표시), 아니면 설치 토큰으로 익명 작성한다.
+ * 작성은 GitHub 로그인이 필요하다 (읽기는 계속 익명).
  */
 async function createMessage(config, text, category) {
-    const token = config.userToken ?? Object.values(config.installations)[0]?.token;
+    const token = config.userToken;
     if (!token)
-        return { ok: false, error: "UNAUTHORIZED" };
+        return { ok: false, error: "LOGIN_REQUIRED" };
     try {
         const res = await fetch(config.apiBaseUrl + "/messages", {
             method: "POST",
@@ -174,10 +174,13 @@ async function createMessage(config, text, category) {
         return { ok: false, error: "NETWORK" };
     }
 }
-/** POST /installations/link — 로그인 후 기존 익명 설치를 계정에 연결한다. */
-async function linkInstallation(config, installationId) {
+/**
+ * POST /installations/link — 로그인 후 기존 익명 설치를 계정에 연결한다.
+ * 소유 증명으로 installation "토큰"을 보낸다 (ID만으로는 연결 불가).
+ */
+async function linkInstallation(config, installationToken) {
     if (!config.userToken)
         return false;
-    const res = await request(config, "POST", "/installations/link", { token: config.userToken, body: { installationId } });
+    const res = await request(config, "POST", "/installations/link", { token: config.userToken, body: { installationToken } });
     return res?.linked === true;
 }

package/dist/cli.js

@@ -19,8 +19,8 @@ const HELP = `pinglet v${config_1.VERSION} — AI가 생각하는 동안 만나
   install [--api <url>] [--force]   Claude Code / Codex 자동 감지 후 integration 설치
           [--claude | --codex]      특정 agent만 설치
   uninstall [--purge]               integration 제거 (--purge: ~/.pinglet까지 삭제)
-  login [--token <jwt>]             GitHub 계정 연결 (선택)
-  post "메시지" [--category <c>]     메시지 작성 (설치만 해도 익명 작성 가능)
+  login [--token <jwt>]             GitHub 계정 연결
+  post "메시지" [--category <c>]     메시지 작성 (GitHub 로그인 필요, 읽기는 익명 가능)
   doctor                            설치/캐시/서버 상태 진단
   ping                              메시지 미리보기
 

package/dist/commands/doctor.js

@@ -81,6 +81,6 @@ async function runDoctor() {
     if (config.userToken)
         ok("로그인됨");
     else
-        warn("로그인 안 됨 — 익명 작성은 가능, 닉네임 표시/반응은 `pinglet login` 후");
+        warn("로그인 안 됨 — 읽기는 가능, 메시지 작성/반응은 `pinglet login` 후");
     console.log("");
 }

package/dist/commands/install.js

@@ -73,6 +73,6 @@ async function runInstall(args) {
     }
     console.log("\n설치 완료! 평소처럼 claude 또는 codex를 실행하면 Ping이 표시됩니다.");
     console.log("  상태 확인:   pinglet doctor");
-    console.log('  메시지 작성: pinglet post "메시지"  (익명 — 바로 가능)');
-    console.log("  계정 연결:   pinglet login  (선택 — 닉네임 표시/반응에 필요)");
+    console.log('  메시지 작성: pinglet login 후 pinglet post "메시지"');
+    console.log("  계정 연결:   pinglet login  (메시지 작성/반응에 필요)");
 }

package/dist/commands/login.js

@@ -61,7 +61,8 @@ async function runLogin(args) {
     }
     if (!token) {
         const url = `${config.apiBaseUrl}/auth/github`;
-        console.log("\n브라우저에서 GitHub 로그인 후, 응답 JSON의 token 값을 붙여넣어 주세요.");
+        console.log(`\n로그인하면 이용약관(${config.apiBaseUrl}/terms)과 개인정보처리방침(${config.apiBaseUrl}/privacy)에 동의하는 것으로 간주됩니다.`);
+        console.log("브라우저에서 GitHub 로그인 후, 응답 JSON의 token 값을 붙여넣어 주세요.");
         console.log(`  ${url}\n`);
         if (process.platform === "darwin") {
             try {
@@ -82,7 +83,7 @@ async function runLogin(args) {
     (0, config_1.saveConfig)(config);
     console.log("✓ 로그인 정보 저장 완료");
     for (const [agentType, record] of Object.entries(config.installations)) {
-        const linked = await (0, api_1.linkInstallation)(config, record.installationId);
+        const linked = await (0, api_1.linkInstallation)(config, record.token);
         console.log(linked
             ? `✓ ${agentType} installation을 계정에 연결했습니다`
             : `○ ${agentType} installation 연결 실패 — 서버 연결 후 다시 시도하세요`);

package/dist/commands/post.js

@@ -10,6 +10,7 @@ const REASON_LABELS = {
     URL_NOT_ALLOWED: "URL은 허용되지 않습니다",
     PII_DETECTED: "이메일/전화번호 등 개인정보가 포함되어 있습니다",
     BANNED_WORD: "정책상 검토가 필요한 표현이 포함되어 있습니다",
+    CONTROL_CHARS: "제어 문자(escape sequence)는 허용되지 않습니다",
 };
 /**
  * `pinglet post "메시지" [--category <카테고리>] [--quiet]`
@@ -40,8 +41,11 @@ async function runPost(args) {
     const result = await (0, api_1.createMessage)(config, text, category);
     if (!result.ok) {
         switch (result.error) {
+            case "LOGIN_REQUIRED":
+                console.log("✗ 메시지 작성에는 GitHub 로그인이 필요합니다. `pinglet login`을 실행하세요 (읽기는 로그인 없이 가능).");
+                break;
             case "UNAUTHORIZED":
-                console.log("✗ 인증 정보가 없습니다. 먼저 `pinglet install`을 실행하세요 (로그인 없이도 익명 작성 가능).");
+                console.log("✗ 로그인이 만료됐습니다. `pinglet login`으로 다시 로그인하세요.");
                 break;
             case "RATE_LIMITED":
                 console.log("✗ 작성 제한(분당 5개)에 걸렸습니다. 잠시 후 다시 시도하세요.");
@@ -67,9 +71,6 @@ async function runPost(args) {
             console.log("✓ 메시지가 등록됐습니다. 곧 다른 개발자들의 터미널에 표시됩니다.");
             if (!quiet) {
                 console.log(`  id: ${result.id}`);
-                if (!config.userToken) {
-                    console.log("  '익명의 개발자'로 표시됩니다 — 닉네임을 달려면 `pinglet login`");
-                }
             }
             break;
         case "PENDING_REVIEW":

package/dist/render.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.supportsUnicode = supportsUnicode;
+exports.sanitizeForTerminal = sanitizeForTerminal;
 exports.formatPing = formatPing;
 exports.formatMyReach = formatMyReach;
 /** 터미널 독립 원칙: unicode가 불확실하면 plain ASCII로 fallback (아키텍처 §5). */
@@ -10,18 +11,30 @@ function supportsUnicode() {
     const locale = process.env.LC_ALL || process.env.LC_CTYPE || process.env.LANG || "";
     return /utf-?8/i.test(locale);
 }
+/**
+ * 터미널에 그리기 전 최종 방어선: 제어·서식 문자를 제거한다.
+ * 서버 moderation이 이미 거르지만, 구버전 서버·손상된 캐시를 신뢰하지 않는다
+ * (ANSI escape가 살아 있으면 수신자 터미널을 조작할 수 있다).
+ */
+function sanitizeForTerminal(text) {
+    return text
+        .replace(/\s+/g, " ")
+        .replace(/[\p{Cc}\p{Cf}]/gu, "")
+        .trim();
+}
 /** 작성자 닉네임 없이 메시지만 표시한다 (spinner verb용). */
 function formatPing(message) {
     const sponsored = message.contentType === "SPONSORED" ? "[AD] " : "";
+    const text = sanitizeForTerminal(message.text);
     if (supportsUnicode()) {
-        return `💌 ${sponsored}"${message.text}"`;
+        return `💌 ${sponsored}"${text}"`;
     }
-    return `[ping] ${sponsored}"${message.text}"`;
+    return `[ping] ${sponsored}"${text}"`;
 }
 const REACH_TEXT_MAX = 24;
 /** statusline용: 내가 쓴 최근 메시지의 도달 현황 한 줄 (커버리지 = 도달/활성 설치). */
 function formatMyReach(stats) {
-    let text = stats.text;
+    let text = sanitizeForTerminal(stats.text);
     if (text.length > REACH_TEXT_MAX)
         text = text.slice(0, REACH_TEXT_MAX - 1) + "…";
     const reached = stats.reachedInstallations;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pinglet-cli",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "description": "AI가 생각하는 동안 다른 개발자의 Ping을 만나는 메시지 네트워크 — Claude Code / Codex integration",
   "license": "MIT",
   "repository": {