pinglet-cli 0.2.8 → 0.2.10

package/README.md

@@ -5,10 +5,14 @@
 Claude Code가 코드를 고치는 동안 "Befuddling…" 스피너만 바라보던 그 자리에,
 다른 개발자들이 남긴 짧은 메시지(**Ping**)가 대신 표시됩니다.
 
+![Pinglet 데모 — Claude Code 스피너 자리에 다른 개발자의 Ping이 표시된다](docs/pinglet-demo.gif)
+
 ```
 ✶ 💌 "금요일 오후 배포는 다음 생에 합시다." (12s · ↓ 1.2k tokens)
 ```
 
+🌐 **홈페이지**: https://pinglet.halluci.co.kr
+
 ## 시작하기
 
 ```bash
@@ -23,6 +27,7 @@ npm install -g pinglet-cli && pinglet install
 
 - 기존 statusline 설정이 있다면 **백업 후 교체할지 물어보고**, 제거 시 원래대로 복원합니다.
 - Codex도 지원합니다(experimental) — turn 완료 시 macOS 알림으로 Ping이 도착합니다.
+  알림 방식이 시끄러울 수 있어 기본 설치에서는 제외되며, 원할 때만 `pinglet install --codex`로 켜세요.
 
 ## Ping 보내기
 
@@ -50,7 +55,7 @@ pinglet post "메시지"
 
 | 명령 | 설명 |
 |---|---|
-| `pinglet install` | Claude Code / Codex 감지 후 연결 |
+| `pinglet install` | Claude Code 연결 (Codex는 `--codex`로 opt-in) |
 | `pinglet login` | GitHub 계정 연결 (메시지 작성에 필요) |
 | `pinglet post "메시지"` | Ping 보내기 |
 | `pinglet ping` | 지금 표시될 메시지 미리보기 |

package/dist/adapters/claude.js

@@ -77,10 +77,27 @@ function statusLineCommand() {
 function isPingletHookEntry(entry) {
     return (entry.hooks?.some((h) => typeof h.command === "string" && h.command.includes("hook-prompt")) ?? false);
 }
+/**
+ * `/pinglet` 인라인 bash를 허용하는 settings.json 권한 규칙.
+ * auto 권한 모드에서는 allow 규칙에 없는 Bash 명령을 LLM 분류기가 심사하는데,
+ * 메시지 내용("~해라" 같은 명령문)에 따라 차단될 수 있어 규칙으로 명시한다.
+ */
+function postPermissionRule() {
+    return `Bash(node "${(0, config_1.cliPath)()}" post:*)`;
+}
+/** Pinglet이 등록한 post 권한 규칙인지 식별 (경로가 바뀐 옛 규칙 포함). */
+function isPingletPermissionRule(rule) {
+    return (rule === postPermissionRule() ||
+        (rule.startsWith('Bash(node "') &&
+            rule.includes("pinglet") &&
+            rule.endsWith('" post:*)')));
+}
 /**
  * `/pinglet` slash command 파일을 설치한다.
  * 등록 자체는 command 안의 인라인 bash(`!` 실행)가 수행하고,
  * 모델은 그 결과 한 줄만 전달하므로 토큰 사용이 매우 적다.
+ * $ARGUMENTS는 따옴표로 감싸 메시지 전체가 하나의 인자로 전달되게 한다
+ * (메시지 속 단어가 셸/CLI 플래그로 해석되는 것을 방지).
  */
 function installSlashCommand() {
     fs.mkdirSync(COMMANDS_DIR, { recursive: true });
@@ -90,7 +107,7 @@ allowed-tools: Bash(node:*)
 ---
 <!-- ${COMMAND_MARKER} -->
 
-등록 결과: !\`node "${(0, config_1.cliPath)()}" post --quiet $ARGUMENTS\`
+등록 결과: !\`node "${(0, config_1.cliPath)()}" post --quiet "$ARGUMENTS"\`
 
 위 등록 결과 줄을 아무것도 덧붙이거나 바꾸지 말고 그대로 한 줄만 출력하세요.
 다른 설명, 안내, 작업을 일절 하지 마세요.
@@ -305,6 +322,12 @@ function installClaudeIntegration(config, options = {}) {
         (0, config_1.saveConfig)(config);
         settings.statusLine = { type: "command", command: statusLineCommand() };
         uninstallPromptHook(settings); // 구버전 hook 방식 흔적 정리
+        // /pinglet 인라인 bash가 auto 모드 분류기에 막히지 않도록 allow 규칙 등록.
+        // 경로가 바뀐(예: node 버전 업) 옛 규칙은 정리하고 현재 규칙 하나만 둔다.
+        const permissions = (settings.permissions ??= {});
+        const allow = (permissions.allow ??= []);
+        const kept = allow.filter((rule) => !isPingletPermissionRule(rule));
+        permissions.allow = [...kept, postPermissionRule()];
         if (!writeSettings(settings, mtimeMs))
             continue; // 다른 프로세스와 충돌 → 재읽기
         installSlashCommand();
@@ -338,6 +361,20 @@ function uninstallClaudeIntegration(config) {
         if (uninstallPromptHook(settings)) {
             settingsChanged = true;
         }
+        const allow = settings.permissions?.allow;
+        if (allow?.some(isPingletPermissionRule)) {
+            const kept = allow.filter((rule) => !isPingletPermissionRule(rule));
+            if (kept.length > 0) {
+                settings.permissions.allow = kept;
+            }
+            else {
+                delete settings.permissions.allow;
+                if (Object.keys(settings.permissions).length === 0) {
+                    delete settings.permissions;
+                }
+            }
+            settingsChanged = true;
+        }
         const verbs = settings.spinnerVerbs;
         if (verbs?.verbs?.some(isPingletTip)) {
             const verbsBackup = config.adapters.claude?.spinnerVerbsBackup;

package/dist/adapters/codex.js

@@ -74,17 +74,53 @@ function readToml() {
         return "";
     }
 }
-function findNotifyLine(toml) {
-    const match = toml.match(/^\s*notify\s*=.*$/m);
-    return match ? match[0] : null;
+/**
+ * config.toml에서 notify 항목 **전체**를 찾는다. TOML 배열은 여러 줄에
+ * 걸칠 수 있으므로 (Codex Computer Use 앱 등이 그렇게 쓴다) 값이 `[`로
+ * 시작하면 문자열 리터럴을 건너뛰며 짝이 맞는 `]`까지를 항목으로 본다.
+ * 한 줄만 매칭하면 교체/삭제 시 배열 본문이 고아로 남아 TOML이 깨진다.
+ */
+function findNotifyEntry(toml) {
+    const head = toml.match(/^[ \t]*notify[ \t]*=[ \t]*/m);
+    if (!head || head.index === undefined)
+        return null;
+    const start = head.index;
+    let i = start + head[0].length;
+    if (toml[i] !== "[") {
+        const lineEnd = toml.indexOf("\n", i);
+        return toml.slice(start, lineEnd === -1 ? toml.length : lineEnd);
+    }
+    let depth = 0;
+    for (; i < toml.length; i++) {
+        const ch = toml[i];
+        if (ch === '"' || ch === "'") {
+            const quote = ch;
+            i++;
+            while (i < toml.length && toml[i] !== quote) {
+                if (quote === '"' && toml[i] === "\\")
+                    i++; // basic string escape
+                i++;
+            }
+        }
+        else if (ch === "[") {
+            depth++;
+        }
+        else if (ch === "]") {
+            depth--;
+            if (depth === 0)
+                return toml.slice(start, i + 1);
+        }
+    }
+    // 괄호 짝이 안 맞음 — 이미 깨진 파일이므로 건드리지 않는다.
+    return null;
 }
 function isCodexIntegrationInstalled() {
-    const line = findNotifyLine(readToml());
-    return (line !== null && (line.includes("pinglet") || line.includes((0, config_1.cliPath)())));
+    const entry = findNotifyEntry(readToml());
+    return (entry !== null && (entry.includes("pinglet") || entry.includes((0, config_1.cliPath)())));
 }
 function installCodexIntegration(config, options = {}) {
     const toml = readToml();
-    const existing = findNotifyLine(toml);
+    const existing = findNotifyEntry(toml);
     const isOurs = existing !== null &&
         (existing.includes("pinglet") || existing.includes((0, config_1.cliPath)()));
     if (existing && !isOurs && !options.force) {
@@ -95,6 +131,8 @@ function installCodexIntegration(config, options = {}) {
         };
     }
     config.adapters.codex = {
+        // 재설치 시 기존 백업(notifyBackup)이 날아가지 않게 유지한다.
+        ...config.adapters.codex,
         installedAt: new Date().toISOString(),
         configPath: CONFIG_TOML_PATH,
         ...(existing && !isOurs && { notifyBackup: existing }),
@@ -114,7 +152,7 @@ function installCodexIntegration(config, options = {}) {
 }
 function uninstallCodexIntegration(config) {
     const toml = readToml();
-    const existing = findNotifyLine(toml);
+    const existing = findNotifyEntry(toml);
     const isOurs = existing !== null &&
         (existing.includes("pinglet") || existing.includes((0, config_1.cliPath)()));
     if (!existing || !isOurs)

package/dist/cli.js

@@ -16,8 +16,8 @@ const HELP = `pinglet v${config_1.VERSION} — AI가 생각하는 동안 만나
 
 사용법: pinglet <command>
 
-  install [--api <url>] [--force]   Claude Code / Codex 자동 감지 후 integration 설치
-          [--claude | --codex]      특정 agent만 설치
+  install [--api <url>] [--force]   Claude Code integration 설치
+          [--claude | --codex]      Codex는 OS 알림 방식이라 --codex로 opt-in (experimental)
   uninstall [--purge]               integration 제거 (--purge: ~/.pinglet까지 삭제)
   login [--token <jwt>]             GitHub 계정 연결
   post "메시지" [--category <c>]     메시지 작성 (GitHub 로그인 필요, 읽기는 익명 가능)

package/dist/commands/install.js

@@ -61,11 +61,12 @@ function confirmReplace(question) {
 }
 async function runInstall(args) {
     const force = args.includes("--force");
-    // --claude / --codex로 대상을 고를 수 있다. 둘 다 없으면 감지된 전부.
+    // Claude는 기본 설치 대상. Codex는 TUI에 그릴 수 없어 OS 알림으로 전달하는
+    // 방식인데 이게 체감상 시끄러워서, --codex를 명시한 경우에만(opt-in) 설치한다.
     const onlyClaude = args.includes("--claude");
     const onlyCodex = args.includes("--codex");
     const wantClaude = onlyClaude || !onlyCodex;
-    const wantCodex = onlyCodex || !onlyClaude;
+    const wantCodex = onlyCodex;
     const config = (0, config_1.loadConfig)();
     const apiIndex = args.indexOf("--api");
     if (apiIndex !== -1 && args[apiIndex + 1]) {
@@ -76,7 +77,12 @@ async function runInstall(args) {
     const hasClaude = wantClaude && (0, claude_1.detectClaude)();
     const hasCodex = wantCodex && (0, codex_1.detectCodex)();
     console.log(hasClaude ? "✓ Claude Code detected" : "○ Claude Code not found");
-    console.log(hasCodex ? "✓ Codex detected" : "○ Codex not found");
+    if (wantCodex) {
+        console.log(hasCodex ? "✓ Codex detected" : "○ Codex not found");
+    }
+    else if ((0, codex_1.detectCodex)()) {
+        console.log("○ Codex 감지됨 — OS 알림 방식이라 기본 설치에서 제외합니다 (원하면 pinglet install --codex)");
+    }
     if (!hasClaude && !hasCodex) {
         console.log("\n설치할 대상이 없습니다. Claude Code 또는 Codex를 먼저 설치해 주세요.");
         process.exitCode = 1;
@@ -134,7 +140,10 @@ async function runInstall(args) {
             }
         }
     }
-    console.log("\n설치 완료! 평소처럼 claude 또는 codex를 실행하면 Ping이 표시됩니다.");
+    const targets = [hasClaude && "claude", hasCodex && "codex"]
+        .filter(Boolean)
+        .join(" 또는 ");
+    console.log(`\n설치 완료! 평소처럼 ${targets}를 실행하면 Ping이 표시됩니다.`);
     console.log("  상태 확인:   pinglet doctor");
     console.log('  메시지 작성: pinglet login 후 pinglet post "메시지"');
     console.log("  계정 연결:   pinglet login  (메시지 작성/반응에 필요)");

package/package.json

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