pinglet-cli 0.1.0

package/dist/api.js

@@ -0,0 +1,173 @@
+"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.MAX_BATCH_SIZE = void 0;
+exports.checkHealth = checkHealth;
+exports.registerInstallation = registerInstallation;
+exports.fetchFeed = fetchFeed;
+exports.uploadEventBatch = uploadEventBatch;
+exports.sendHeartbeat = sendHeartbeat;
+exports.createMessage = createMessage;
+exports.linkInstallation = linkInstallation;
+const os = __importStar(require("os"));
+const crypto_1 = require("crypto");
+const config_1 = require("./config");
+const TIMEOUT_MS = 5000;
+/** 서버 EventBatchDto의 ArrayMaxSize(200)와 맞춘다. */
+exports.MAX_BATCH_SIZE = 200;
+async function request(config, method, apiPath, options = {}) {
+    try {
+        const res = await fetch(config.apiBaseUrl + apiPath, {
+            method,
+            headers: {
+                "content-type": "application/json",
+                ...(options.token && { authorization: `Bearer ${options.token}` }),
+            },
+            ...(options.body !== undefined && { body: JSON.stringify(options.body) }),
+            signal: AbortSignal.timeout(TIMEOUT_MS),
+        });
+        if (!res.ok)
+            return null;
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+}
+async function checkHealth(config) {
+    const res = await request(config, "GET", "/health");
+    return res?.status === "ok";
+}
+/** POST /installations — 익명 등록. 로그인 상태면 userToken으로 귀속된다. */
+async function registerInstallation(config, agentType) {
+    const res = await request(config, "POST", "/installations", {
+        token: config.userToken,
+        body: {
+            agentType,
+            os: `${process.platform}-${os.release()}`.slice(0, 50),
+            clientVersion: config_1.VERSION,
+        },
+    });
+    if (!res?.installationId || !res.token)
+        return null;
+    return {
+        installationId: res.installationId,
+        token: res.token,
+        registeredAt: new Date().toISOString(),
+    };
+}
+/** GET /feed — 로컬 캐시용 메시지 30~50개를 미리 받는다. */
+async function fetchFeed(config, record, limit = 50) {
+    const res = await request(config, "GET", `/feed?limit=${limit}`, { token: record.token });
+    if (!res?.items)
+        return null;
+    return res.items
+        .filter((item) => item.messageId && item.text)
+        .map((item) => ({
+        id: item.messageId,
+        text: item.text,
+        author: item.authorNickname || "익명의 개발자",
+        category: item.category,
+        contentType: item.contentType === "SYSTEM" || item.contentType === "SPONSORED"
+            ? item.contentType
+            : "USER",
+    }));
+}
+/** POST /events/batch — eventId 기반으로 서버가 dedupe하므로 재전송에 안전하다. */
+async function uploadEventBatch(config, record, events) {
+    const res = await request(config, "POST", "/events/batch", {
+        token: record.token,
+        body: {
+            batchId: "batch_" + (0, crypto_1.randomUUID)(),
+            events: events.map(({ eventId, type, messageId, visibleMs, occurredAt }) => ({
+                eventId,
+                type,
+                messageId,
+                ...(visibleMs !== undefined && { visibleMs }),
+                occurredAt,
+            })),
+        },
+    });
+    return res !== null;
+}
+async function sendHeartbeat(config, record) {
+    await request(config, "POST", "/installations/heartbeat", {
+        token: record.token,
+        body: { clientVersion: config_1.VERSION },
+    });
+}
+/**
+ * POST /messages — 메시지 작성 (분당 5개 제한).
+ * 로그인했으면 유저 토큰으로(닉네임 표시), 아니면 설치 토큰으로 익명 작성한다.
+ */
+async function createMessage(config, text, category) {
+    const token = config.userToken ?? Object.values(config.installations)[0]?.token;
+    if (!token)
+        return { ok: false, error: "UNAUTHORIZED" };
+    try {
+        const res = await fetch(config.apiBaseUrl + "/messages", {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify({ text, ...(category && { category }) }),
+            signal: AbortSignal.timeout(TIMEOUT_MS),
+        });
+        if (res.status === 401)
+            return { ok: false, error: "UNAUTHORIZED" };
+        if (res.status === 429)
+            return { ok: false, error: "RATE_LIMITED" };
+        if (!res.ok)
+            return { ok: false, error: "SERVER" };
+        const body = (await res.json());
+        return {
+            ok: true,
+            id: body.id,
+            status: body.status,
+            moderationReason: body.moderationReason,
+        };
+    }
+    catch {
+        return { ok: false, error: "NETWORK" };
+    }
+}
+/** POST /installations/link — 로그인 후 기존 익명 설치를 계정에 연결한다. */
+async function linkInstallation(config, installationId) {
+    if (!config.userToken)
+        return false;
+    const res = await request(config, "POST", "/installations/link", { token: config.userToken, body: { installationId } });
+    return res?.linked === true;
+}

package/dist/cache.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFeedMessages = loadFeedMessages;
+exports.saveFeedMessages = saveFeedMessages;
+exports.feedAgeMs = feedAgeMs;
+exports.loadState = loadState;
+exports.saveState = saveState;
+const config_1 = require("./config");
+/**
+ * 렌더링 path에서 호출되므로 전부 동기 I/O — 네트워크는 절대 타지 않는다.
+ * 서버 feed를 아직 못 받았으면 빈 배열 — Pinglet은 아무것도 표시하지 않고
+ * Claude Code 기본 spinner가 그대로 유지된다.
+ */
+function loadFeedMessages() {
+    const cache = (0, config_1.readJsonFile)(config_1.FEED_PATH);
+    return cache?.messages ?? [];
+}
+function saveFeedMessages(messages) {
+    const file = {
+        fetchedAt: new Date().toISOString(),
+        messages,
+    };
+    (0, config_1.writeJsonFile)(config_1.FEED_PATH, file);
+}
+/** 서버 feed를 마지막으로 받은 시점부터의 경과(ms). 캐시가 없으면 null. */
+function feedAgeMs() {
+    const cache = (0, config_1.readJsonFile)(config_1.FEED_PATH);
+    if (!cache?.fetchedAt)
+        return null;
+    const t = Date.parse(cache.fetchedAt);
+    return Number.isNaN(t) ? null : Date.now() - t;
+}
+function loadState() {
+    const state = (0, config_1.readJsonFile)(config_1.STATE_PATH);
+    if (state) {
+        state.seen ??= {};
+        return state;
+    }
+    return { seen: {} };
+}
+function saveState(state) {
+    // seen map이 무한히 자라지 않게 상한을 둔다.
+    const keys = Object.keys(state.seen);
+    if (keys.length > 500) {
+        for (const key of keys.slice(0, keys.length - 500)) {
+            delete state.seen[key];
+        }
+    }
+    (0, config_1.writeJsonFile)(config_1.STATE_PATH, state);
+}

package/dist/cli.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("./config");
+const install_1 = require("./commands/install");
+const uninstall_1 = require("./commands/uninstall");
+const doctor_1 = require("./commands/doctor");
+const login_1 = require("./commands/login");
+const statusline_1 = require("./commands/statusline");
+const notify_1 = require("./commands/notify");
+const flush_1 = require("./commands/flush");
+const refresh_1 = require("./commands/refresh");
+const ping_1 = require("./commands/ping");
+const post_1 = require("./commands/post");
+const HELP = `pinglet v${config_1.VERSION} — AI가 생각하는 동안 만나는 개발자 메시지 네트워크
+
+사용법: pinglet <command>
+
+  install [--api <url>] [--force]   Claude Code / Codex 자동 감지 후 integration 설치
+          [--claude | --codex]      특정 agent만 설치
+  uninstall [--purge]               integration 제거 (--purge: ~/.pinglet까지 삭제)
+  login [--token <jwt>]             GitHub 계정 연결 (선택)
+  post "메시지" [--category <c>]     메시지 작성 (설치만 해도 익명 작성 가능)
+  doctor                            설치/캐시/서버 상태 진단
+  ping                              메시지 미리보기
+
+내부 명령 (integration이 호출):
+  statusline                        Claude Code statusLine hook
+  notify                            Codex notify hook
+  flush                             이벤트 큐 batch 전송
+  refresh                           feed 캐시 갱신 + heartbeat
+`;
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    switch (command) {
+        case "install":
+            await (0, install_1.runInstall)(rest);
+            break;
+        case "uninstall":
+            (0, uninstall_1.runUninstall)(rest);
+            break;
+        case "login":
+            await (0, login_1.runLogin)(rest);
+            break;
+        case "doctor":
+            await (0, doctor_1.runDoctor)();
+            break;
+        case "post":
+            await (0, post_1.runPost)(rest);
+            break;
+        case "ping":
+            (0, ping_1.runPing)();
+            break;
+        case "statusline":
+            (0, statusline_1.runStatusline)();
+            break;
+        case "notify":
+            (0, notify_1.runNotify)(rest);
+            break;
+        case "flush":
+            await (0, flush_1.runFlush)();
+            break;
+        case "refresh":
+            await (0, refresh_1.runRefresh)();
+            break;
+        case "--version":
+        case "-v":
+            console.log(config_1.VERSION);
+            break;
+        default:
+            console.log(HELP);
+            if (command && command !== "help" && command !== "--help") {
+                process.exitCode = 1;
+            }
+    }
+}
+main().catch((error) => {
+    // statusline/notify는 조용히 실패해야 Claude/Codex 경험을 해치지 않는다.
+    const command = process.argv[2];
+    if (command === "statusline" || command === "notify") {
+        process.exit(0);
+    }
+    console.error("pinglet:", error instanceof Error ? error.message : error);
+    process.exit(1);
+});

package/dist/commands/doctor.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+const config_1 = require("../config");
+const api_1 = require("../api");
+const cache_1 = require("../cache");
+const queue_1 = require("../queue");
+const claude_1 = require("../adapters/claude");
+const codex_1 = require("../adapters/codex");
+const ok = (label) => console.log(`✓ ${label}`);
+const warn = (label) => console.log(`○ ${label}`);
+const bad = (label) => console.log(`✗ ${label}`);
+async function runDoctor() {
+    const config = (0, config_1.loadConfig)();
+    console.log("");
+    const nodeMajor = Number(process.versions.node.split(".")[0]);
+    if (nodeMajor >= 18)
+        ok(`Node.js ${process.versions.node}`);
+    else
+        bad(`Node.js ${process.versions.node} — 18 이상이 필요합니다`);
+    // Claude
+    if ((0, claude_1.detectClaude)()) {
+        ok("Claude Code detected");
+        if ((0, claude_1.isClaudeIntegrationInstalled)()) {
+            ok("Claude integration installed");
+            const spinner = (0, claude_1.spinnerVerbsStatus)();
+            if (spinner.count > 0) {
+                ok(`Spinner 메시지: ${spinner.count}개 등록됨`);
+            }
+            else {
+                warn("Spinner 메시지 미등록 — `pinglet refresh` 실행");
+            }
+        }
+        else
+            warn("Claude integration not installed — `pinglet install` 실행");
+    }
+    else {
+        warn("Claude Code not found");
+    }
+    // Codex
+    if ((0, codex_1.detectCodex)()) {
+        ok("Codex detected");
+        if ((0, codex_1.isCodexIntegrationInstalled)())
+            ok("Codex integration installed");
+        else
+            warn("Codex integration not installed — `pinglet install` 실행");
+    }
+    else {
+        warn("Codex not found");
+    }
+    // 서버 등록 상태
+    for (const agentType of ["CLAUDE", "CODEX"]) {
+        const record = config.installations[agentType];
+        if (record)
+            ok(`${agentType} installation registered (${record.installationId})`);
+    }
+    if (Object.keys(config.installations).length === 0) {
+        warn("서버에 등록된 installation이 없습니다 (오프라인 설치 상태)");
+    }
+    // 로컬 캐시 / 큐
+    const messages = (0, cache_1.loadFeedMessages)();
+    const age = (0, cache_1.feedAgeMs)();
+    if (messages.length === 0) {
+        warn("Feed cache 비어 있음 — 기본 spinner로 표시 중 (서버 feed 수신 후 Ping 표시)");
+    }
+    else {
+        const ageMin = age === null ? "?" : Math.round(age / 60_000);
+        ok(`Feed cache: ${messages.length}개 (${ageMin}분 전 갱신)`);
+    }
+    const queued = (0, queue_1.countEvents)();
+    if (queued < 200)
+        ok(`Event queue: ${queued}개 대기`);
+    else
+        warn(`Event queue: ${queued}개 대기 — 서버 전송이 밀려 있습니다`);
+    // API
+    const online = await (0, api_1.checkHealth)(config);
+    if (online)
+        ok(`API reachable (${config.apiBaseUrl})`);
+    else
+        warn(`API unreachable (${config.apiBaseUrl}) — 오프라인 모드로 동작 중`);
+    if (config.userToken)
+        ok("로그인됨");
+    else
+        warn("로그인 안 됨 — 익명 작성은 가능, 닉네임 표시/반응은 `pinglet login` 후");
+    console.log("");
+}

package/dist/commands/flush.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFlush = runFlush;
+const config_1 = require("../config");
+const api_1 = require("../api");
+const queue_1 = require("../queue");
+/**
+ * Local Event Queue를 batch로 서버에 전송한다 (아키텍처 §8).
+ * 전송 성공한 이벤트만 큐에서 제거하므로 실패분은 다음 주기에 재시도되고,
+ * 재전송 중복은 서버가 eventId로 dedupe한다.
+ */
+async function runFlush() {
+    const config = (0, config_1.loadConfig)();
+    const events = (0, queue_1.readEvents)();
+    if (events.length === 0)
+        return;
+    for (const agentType of ["CLAUDE", "CODEX"]) {
+        const record = config.installations[agentType];
+        const group = events.filter((e) => e.agentType === agentType);
+        if (group.length === 0)
+            continue;
+        if (!record)
+            continue; // 미등록 상태 — refresh가 등록을 재시도한다.
+        for (let i = 0; i < group.length; i += api_1.MAX_BATCH_SIZE) {
+            const chunk = group.slice(i, i + api_1.MAX_BATCH_SIZE);
+            const ok = await (0, api_1.uploadEventBatch)(config, record, chunk);
+            if (!ok)
+                break;
+            (0, queue_1.removeEvents)(new Set(chunk.map((e) => e.eventId)));
+        }
+    }
+}

package/dist/commands/install.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInstall = runInstall;
+const config_1 = require("../config");
+const api_1 = require("../api");
+const cache_1 = require("../cache");
+const claude_1 = require("../adapters/claude");
+const codex_1 = require("../adapters/codex");
+async function runInstall(args) {
+    const force = args.includes("--force");
+    // --claude / --codex로 대상을 고를 수 있다. 둘 다 없으면 감지된 전부.
+    const onlyClaude = args.includes("--claude");
+    const onlyCodex = args.includes("--codex");
+    const wantClaude = onlyClaude || !onlyCodex;
+    const wantCodex = onlyCodex || !onlyClaude;
+    const config = (0, config_1.loadConfig)();
+    const apiIndex = args.indexOf("--api");
+    if (apiIndex !== -1 && args[apiIndex + 1]) {
+        config.apiBaseUrl = args[apiIndex + 1].replace(/\/$/, "");
+        (0, config_1.saveConfig)(config);
+    }
+    console.log("");
+    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 (!hasClaude && !hasCodex) {
+        console.log("\n설치할 대상이 없습니다. Claude Code 또는 Codex를 먼저 설치해 주세요.");
+        process.exitCode = 1;
+        return;
+    }
+    const online = await (0, api_1.checkHealth)(config);
+    if (!online) {
+        console.log(`○ Pinglet 서버(${config.apiBaseUrl})에 연결할 수 없어 오프라인 모드로 설치합니다.`);
+        console.log("  서버 등록과 feed 수신은 온라인 상태가 되면 자동으로 재시도됩니다.");
+    }
+    const register = async (agentType) => {
+        if (config.installations[agentType] || !online)
+            return;
+        const record = await (0, api_1.registerInstallation)(config, agentType);
+        if (record) {
+            config.installations[agentType] = record;
+            (0, config_1.saveConfig)(config);
+        }
+    };
+    if (hasClaude) {
+        await register("CLAUDE");
+        const result = (0, claude_1.installClaudeIntegration)(config, { force });
+        console.log(result.ok
+            ? "✓ Claude integration installed"
+            : `✗ Claude integration skipped — ${result.reason}`);
+    }
+    if (hasCodex) {
+        await register("CODEX");
+        const result = (0, codex_1.installCodexIntegration)(config, { force });
+        console.log(result.ok
+            ? "✓ Codex integration installed (experimental)"
+            : `✗ Codex integration skipped — ${result.reason}`);
+    }
+    // 첫 feed를 미리 받아 로컬 캐시를 채워 둔다.
+    const record = Object.values(config.installations)[0];
+    if (online && record) {
+        const messages = await (0, api_1.fetchFeed)(config, record);
+        if (messages) {
+            (0, cache_1.saveFeedMessages)(messages);
+            if (messages.length > 0) {
+                console.log(`✓ Feed cached (${messages.length} messages)`);
+                if ((0, claude_1.syncSpinnerVerbs)(config, messages)) {
+                    console.log("✓ Claude spinner synced");
+                }
+            }
+        }
+    }
+    console.log("\n설치 완료! 평소처럼 claude 또는 codex를 실행하면 Ping이 표시됩니다.");
+    console.log("  상태 확인:   pinglet doctor");
+    console.log('  메시지 작성: pinglet post "메시지"  (익명 — 바로 가능)');
+    console.log("  계정 연결:   pinglet login  (선택 — 닉네임 표시/반응에 필요)");
+}

package/dist/commands/login.js

@@ -0,0 +1,90 @@
+"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.runLogin = runLogin;
+const child_process_1 = require("child_process");
+const readline = __importStar(require("readline"));
+const config_1 = require("../config");
+const api_1 = require("../api");
+function prompt(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => rl.question(question, (answer) => {
+        rl.close();
+        resolve(answer);
+    }));
+}
+/**
+ * GitHub OAuth 로그인.
+ * 브라우저에서 /auth/github → callback JSON의 token을 CLI에 붙여넣는 방식 (MVP).
+ */
+async function runLogin(args) {
+    const config = (0, config_1.loadConfig)();
+    let token;
+    const tokenIndex = args.indexOf("--token");
+    if (tokenIndex !== -1 && args[tokenIndex + 1]) {
+        token = args[tokenIndex + 1];
+    }
+    if (!token) {
+        const url = `${config.apiBaseUrl}/auth/github`;
+        console.log("\n브라우저에서 GitHub 로그인 후, 응답 JSON의 token 값을 붙여넣어 주세요.");
+        console.log(`  ${url}\n`);
+        if (process.platform === "darwin") {
+            try {
+                (0, child_process_1.spawn)("open", [url], { stdio: "ignore" }).unref();
+            }
+            catch {
+                // 브라우저를 못 열어도 URL은 출력했으므로 진행
+            }
+        }
+        token = (await prompt("token: ")).trim();
+    }
+    if (!token) {
+        console.log("✗ token이 비어 있습니다.");
+        process.exitCode = 1;
+        return;
+    }
+    config.userToken = token;
+    (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);
+        console.log(linked
+            ? `✓ ${agentType} installation을 계정에 연결했습니다`
+            : `○ ${agentType} installation 연결 실패 — 서버 연결 후 다시 시도하세요`);
+    }
+}

package/dist/commands/notify.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runNotify = runNotify;
+const child_process_1 = require("child_process");
+const cache_1 = require("../cache");
+const picker_1 = require("../picker");
+const queue_1 = require("../queue");
+const runtime_1 = require("../runtime");
+/**
+ * Codex CLI notify hook 진입점 (experimental).
+ * Codex는 turn 완료 시 마지막 인자로 notification JSON을 넘긴다.
+ * notify 프로세스는 TUI 밖에서 돌기 때문에 MVP에서는 macOS 알림으로 Ping을 전달한다.
+ */
+function runNotify(args) {
+    let notificationType;
+    try {
+        const payload = JSON.parse(args[args.length - 1] ?? "");
+        notificationType = payload?.type;
+    }
+    catch {
+        // payload가 없으면 그냥 진행 (수동 테스트 허용)
+    }
+    if (notificationType && notificationType !== "agent-turn-complete") {
+        return;
+    }
+    const state = (0, cache_1.loadState)();
+    const now = Date.now();
+    const message = (0, picker_1.pickMessage)((0, cache_1.loadFeedMessages)(), state);
+    if (!message) {
+        (0, runtime_1.runMaintenance)(state, now);
+        (0, cache_1.saveState)(state);
+        return;
+    }
+    (0, queue_1.appendEvent)({ agentType: "CODEX", type: "DELIVERED", messageId: message.id });
+    state.seen[message.id] = (state.seen[message.id] ?? 0) + 1;
+    (0, runtime_1.runMaintenance)(state, now);
+    (0, cache_1.saveState)(state);
+    if (process.platform === "darwin") {
+        const body = message.text.replace(/["\\]/g, "");
+        const title = `Pinglet — ${message.author.replace(/["\\]/g, "")}`;
+        (0, child_process_1.execFile)("osascript", ["-e", `display notification "${body}" with title "${title}"`], () => { });
+    }
+}

package/dist/commands/ping.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPing = runPing;
+const cache_1 = require("../cache");
+const picker_1 = require("../picker");
+const render_1 = require("../render");
+/** 미리보기: 이벤트 기록 없이 메시지 하나를 골라 출력한다. */
+function runPing() {
+    const message = (0, picker_1.pickMessage)((0, cache_1.loadFeedMessages)(), (0, cache_1.loadState)());
+    if (!message) {
+        console.log("표시할 Ping이 없습니다 — 서버 feed를 받으면 표시됩니다.");
+        return;
+    }
+    console.log((0, render_1.formatPing)(message));
+}