loopers-token-cli 0.1.0 → 0.3.0

package/dist/api.js

@@ -1,5 +1,5 @@
 import { IngestPayload } from './schema.js';
-export const CLI_VERSION = '0.1.0';
+export const CLI_VERSION = '0.3.0';
 /** 전송 직전 페이로드를 스키마로 build(검증 + 스키마 외 필드 제거) */
 export function buildPayload(config, stats) {
     // parse는 스키마에 정의된 필드만 남기고 나머지를 제거한다 → 개인정보 차단.
@@ -7,7 +7,6 @@ export function buildPayload(config, stats) {
         schemaVersion: 1,
         deviceId: config.deviceId,
         nickname: config.nickname,
-        team: config.team,
         cliVersion: CLI_VERSION,
         stats,
     });

package/dist/commands/init.js

@@ -2,6 +2,7 @@ import { randomUUID } from 'node:crypto';
 import { createInterface } from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';
 import { loadConfig, saveConfig, CONFIG_PATH } from '../config.js';
+import { detectGithubUsername, isValidGithubUsername } from '../github.js';
 const DEFAULT_ENDPOINT = 'https://loopers-token-dashboard.vercel.app/api/ingest';
 /** 비대화형(플래그) 또는 대화형으로 config를 생성/갱신한다. deviceId는 1회 생성 후 고정. */
 export async function runInit(opts) {
@@ -9,31 +10,48 @@ export async function runInit(opts) {
     const rl = createInterface({ input: stdin, output: stdout });
     const ask = async (q, fallback) => {
         const suffix = fallback ? ` [${fallback}]` : '';
-        const ans = (await rl.question(`${q}${suffix}: `)).trim();
-        return ans || fallback || '';
+        try {
+            const ans = (await rl.question(`${q}${suffix}: `)).trim();
+            return ans || fallback || '';
+        }
+        catch {
+            return fallback || '';
+        }
     };
     try {
         console.log('\n루퍼스 토큰 대시보드 — 초기 설정');
-        console.log('⚠️  닉네임/팀에 실명·이메일 등 개인정보를 넣지 마세요. 자유 라벨만 사용합니다.\n');
-        const nickname = opts.nickname ?? (await ask('닉네임', existing?.nickname));
-        const team = opts.team ?? (await ask('팀', existing?.team));
+        console.log('⚠️  GitHub username 외 실명·이메일 등 개인정보를 넣지 마세요.\n');
+        // GitHub username 확보: 플래그 > 기존값 > gh 자동감지 > 수동입력
+        let username = opts.nickname ?? existing?.nickname;
+        if (!username) {
+            const detected = await detectGithubUsername();
+            if (detected) {
+                console.log(`🔎 gh CLI에서 GitHub username 감지: ${detected}`);
+            }
+            username = await ask('GitHub username', detected ?? undefined);
+        }
+        if (username && !isValidGithubUsername(username)) {
+            console.error(`\n❌ "${username}" 은(는) 올바른 GitHub username 형식이 아닙니다.`);
+            process.exitCode = 1;
+            return;
+        }
         const endpoint = opts.endpoint ??
             (await ask('서버 endpoint', existing?.endpoint ?? DEFAULT_ENDPOINT));
         const enrollKey = opts.enrollKey ?? (await ask('등록 키(enroll key)', existing?.enrollKey));
-        if (!nickname || !team || !endpoint || !enrollKey) {
-            console.error('\n❌ 닉네임/팀/endpoint/등록 키는 모두 필요합니다.');
+        if (!username || !endpoint || !enrollKey) {
+            console.error('\n❌ GitHub username/endpoint/등록 키는 모두 필요합니다.');
             process.exitCode = 1;
             return;
         }
         const config = {
             deviceId: existing?.deviceId ?? randomUUID(),
-            nickname,
-            team,
+            nickname: username,
             endpoint,
             enrollKey,
         };
         await saveConfig(config);
         console.log(`\n✅ 설정 저장 완료: ${CONFIG_PATH}`);
+        console.log(`   GitHub username: ${config.nickname}`);
         console.log(`   deviceId: ${config.deviceId}`);
         console.log('   이제 `loopers-token sync` 로 전송하세요.\n');
     }

package/dist/commands/install.js

@@ -0,0 +1,159 @@
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+import { mkdir, writeFile, unlink, readFile, access, } from 'node:fs/promises';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { fileURLToPath } from 'node:url';
+import { loadConfig } from '../config.js';
+const exec = promisify(execFile);
+const LABEL = 'app.loopers.token-cli';
+const AGENT_DIR = join(homedir(), 'Library', 'LaunchAgents');
+const PLIST_PATH = join(AGENT_DIR, `${LABEL}.plist`);
+const LOG_DIR = join(homedir(), '.config', 'loopers-token', 'logs');
+/** 현재 실행 중인 CLI의 절대 진입점 경로 (dist/index.js). */
+function cliEntrypoint() {
+    // commands/install.js → dist/index.js
+    return fileURLToPath(new URL('../index.js', import.meta.url));
+}
+/** node 실행 파일 경로. launchd는 PATH가 비어 있으므로 절대경로 필요. */
+function nodePath() {
+    return process.execPath;
+}
+function buildPlist(intervalSeconds) {
+    const node = nodePath();
+    const entry = cliEntrypoint();
+    const outLog = join(LOG_DIR, 'sync.out.log');
+    const errLog = join(LOG_DIR, 'sync.err.log');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${node}</string>
+    <string>${entry}</string>
+    <string>sync</string>
+    <string>--quiet</string>
+  </array>
+  <key>StartInterval</key>
+  <integer>${intervalSeconds}</integer>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${outLog}</string>
+  <key>StandardErrorPath</key>
+  <string>${errLog}</string>
+</dict>
+</plist>
+`;
+}
+async function bootedOut() {
+    // 이미 로드돼 있으면 먼저 내린다(중복 등록 방지). 실패는 무시.
+    try {
+        await exec('launchctl', ['unload', PLIST_PATH]);
+    }
+    catch {
+        /* 미등록 상태면 정상 */
+    }
+}
+export async function runInstall(opts) {
+    if (platform() !== 'darwin') {
+        console.error('❌ 현재 자동 전송 설치는 macOS(launchd)만 지원합니다. ' +
+            'Linux/Windows는 cron 또는 작업 스케줄러로 `loopers-token sync --quiet` 를 등록하세요.');
+        process.exitCode = 1;
+        return;
+    }
+    const config = await loadConfig();
+    if (!config) {
+        console.error('❌ 설정이 없습니다. 먼저 `loopers-token init` 을 실행하세요.');
+        process.exitCode = 1;
+        return;
+    }
+    const minutes = Math.max(5, opts.intervalMinutes ?? 60);
+    const intervalSeconds = minutes * 60;
+    await mkdir(AGENT_DIR, { recursive: true });
+    await mkdir(LOG_DIR, { recursive: true });
+    await bootedOut();
+    await writeFile(PLIST_PATH, buildPlist(intervalSeconds), 'utf8');
+    try {
+        await exec('launchctl', ['load', PLIST_PATH]);
+    }
+    catch (e) {
+        console.error(`❌ launchctl load 실패: ${e.message}`);
+        console.error(`   plist는 작성됨: ${PLIST_PATH}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log('✅ 자동 전송 설치 완료 (launchd)');
+    console.log(`   주기: ${minutes}분마다 sync --quiet`);
+    console.log(`   plist: ${PLIST_PATH}`);
+    console.log(`   로그: ${LOG_DIR}`);
+    console.log('   해제하려면 `loopers-token uninstall` 을 실행하세요.');
+}
+export async function runUninstall() {
+    if (platform() !== 'darwin') {
+        console.error('❌ 자동 전송은 macOS(launchd)만 지원합니다.');
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        await access(PLIST_PATH);
+    }
+    catch {
+        console.log('자동 전송이 설치돼 있지 않습니다. (plist 없음)');
+        return;
+    }
+    await bootedOut();
+    try {
+        await unlink(PLIST_PATH);
+    }
+    catch (e) {
+        console.error(`❌ plist 삭제 실패: ${e.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log('✅ 자동 전송 해제 완료 (launchd unload + plist 삭제)');
+}
+export async function runStatus() {
+    if (platform() !== 'darwin') {
+        console.log('자동 전송 상태 조회는 macOS(launchd)만 지원합니다.');
+        return;
+    }
+    let installed = false;
+    try {
+        await access(PLIST_PATH);
+        installed = true;
+    }
+    catch {
+        /* 미설치 */
+    }
+    if (!installed) {
+        console.log('상태: 미설치. `loopers-token install` 로 자동 전송을 설정하세요.');
+        return;
+    }
+    let loaded = false;
+    try {
+        const { stdout } = await exec('launchctl', ['list']);
+        loaded = stdout.includes(LABEL);
+    }
+    catch {
+        /* list 실패 시 미로드로 간주 */
+    }
+    console.log(`상태: 설치됨 ${loaded ? '(로드됨/활성)' : '(plist만 존재, 미로드)'}`);
+    console.log(`   plist: ${PLIST_PATH}`);
+    // 최근 sync 로그 끝부분 표시
+    const errLog = join(LOG_DIR, 'sync.err.log');
+    try {
+        const raw = await readFile(errLog, 'utf8');
+        const tail = raw.trim().split('\n').slice(-5).join('\n');
+        if (tail) {
+            console.log(`\n최근 에러 로그(${errLog}):`);
+            console.log(tail);
+        }
+    }
+    catch {
+        /* 로그 없음 */
+    }
+}

package/dist/github.js

@@ -0,0 +1,26 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * 로컬 gh CLI(GitHub CLI)로 로그인된 username을 조회한다.
+ * gh 미설치/미로그인 등 어떤 이유로든 실패하면 null.
+ */
+export async function detectGithubUsername() {
+    try {
+        const { stdout } = await execFileAsync('gh', ['api', 'user', '--jq', '.login'], {
+            timeout: 5000,
+        });
+        const login = stdout.trim();
+        return isValidGithubUsername(login) ? login : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * GitHub username 형식 검증.
+ * 규칙: 영숫자와 하이픈, 1~39자, 하이픈으로 시작/끝 불가, 연속 하이픈 불가.
+ */
+export function isValidGithubUsername(name) {
+    return /^[a-zA-Z0-9](?:[a-zA-Z0-9]|-(?=[a-zA-Z0-9])){0,38}$/.test(name);
+}

package/dist/index.js

@@ -2,6 +2,7 @@
 import { Command } from 'commander';
 import { runInit } from './commands/init.js';
 import { runSync } from './commands/sync.js';
+import { runInstall, runUninstall, runStatus } from './commands/install.js';
 import { CLI_VERSION } from './api.js';
 const program = new Command();
 program
@@ -10,14 +11,13 @@ program
     .version(CLI_VERSION);
 program
     .command('init')
-    .description('닉네임/팀/서버 설정 (deviceId는 1회 생성 후 고정)')
-    .option('--nickname <name>', '닉네임 (실명/이메일 금지)')
-    .option('--team <team>', '팀 라벨')
+    .description('GitHub username/서버 설정 (deviceId는 1회 생성 후 고정)')
+    .option('--github-username <name>', 'GitHub username (미지정 시 gh CLI 자동 감지)')
+    .option('--nickname <name>', '(별칭) --github-username 과 동일')
     .option('--endpoint <url>', '서버 ingest endpoint')
     .option('--enroll-key <key>', '부트캠프 공통 등록 키')
     .action((opts) => runInit({
-    nickname: opts.nickname,
-    team: opts.team,
+    nickname: opts.githubUsername ?? opts.nickname,
     endpoint: opts.endpoint,
     enrollKey: opts.enrollKey,
 }));
@@ -27,4 +27,17 @@ program
     .option('--dry-run', '전송하지 않고 페이로드만 출력 (프라이버시 확인용)')
     .option('--quiet', '로그 최소화 (자동 스케줄용)')
     .action((opts) => runSync({ dryRun: opts.dryRun, quiet: opts.quiet }));
+program
+    .command('install')
+    .description('자동 전송 설치 (macOS launchd, 기본 60분마다 sync --quiet)')
+    .option('--interval <minutes>', '동기화 주기(분, 최소 5)', '60')
+    .action((opts) => runInstall({ intervalMinutes: Number.parseInt(opts.interval, 10) }));
+program
+    .command('uninstall')
+    .description('자동 전송 해제 (launchd unload + plist 삭제)')
+    .action(() => runUninstall());
+program
+    .command('status')
+    .description('자동 전송 설치/로드 상태 및 최근 로그 확인')
+    .action(() => runStatus());
 program.parseAsync(process.argv);

package/dist/schema.js

@@ -22,14 +22,13 @@ export const DailyModelStat = z.object({
     cacheReadInputTokens: z.number().int().nonnegative(),
     messageCount: z.number().int().nonnegative(),
 });
-/** 닉네임/팀 — 자유 라벨. 실명/이메일 입력 금지 */
+/** 닉네임 — 자유 라벨. 실명/이메일 입력 금지 */
 export const labelString = z.string().trim().min(1).max(32);
 /** CLI가 중앙 서버 POST /api/ingest 로 보내는 전체 페이로드 */
 export const IngestPayload = z.object({
     schemaVersion: z.literal(1),
     deviceId: z.string().uuid(),
     nickname: labelString,
-    team: labelString,
     cliVersion: z.string().max(20),
     stats: z.array(DailyModelStat).max(2000),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopers-token-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "루퍼스 토큰 대시보드 수집 CLI — ~/.claude 세션의 토큰 집계값만 전송",
   "type": "module",
   "bin": {