@mulsok/traders-client 0.1.0 → 0.2.0

package/bin/cli.js

@@ -1,17 +1,26 @@
 #!/usr/bin/env node
 /**
- * mulsok-client CLI
+ * mulsok-client CLI · headless / SSH 환경 지원
  *
  * 사용:
- *   mulsok-client install     · 데몬 등록 + 가동 (postinstall 에서 자동 호출)
- *   mulsok-client uninstall   · 데몬 제거 (데이터 보존)
- *   mulsok-client status      · 현재 상태 (launchctl + readiness)
- *   mulsok-client logs        · 로그 실시간 (tail -f)
- *   mulsok-client update      · npm update + 데몬 재시작
- *   mulsok-client help        · 이 메시지
+ *   mulsok-client install / uninstall / update           · 데몬 lifecycle
+ *   mulsok-client status                                  · daemon 상태
+ *   mulsok-client logs                                    · 로그 tail -f
+ *   mulsok-client config show                             · 현재 설정 (마스킹)
+ *   mulsok-client config token [<TOKEN>]                  · 디바이스 인증
+ *   mulsok-client config llm <provider> [--api-key=K]
+ *                                       [--model=M]       · LLM provider 설정
+ *   mulsok-client config broker kiwoom --app-key=K
+ *                          --app-secret=S [--demo|--live] · 키움 등록
+ *   mulsok-client config subs list|add|remove [<slug>]    · 구독 관리
+ *   mulsok-client help                                    · 이 메시지
+ *
+ * 모든 config 명령은 daemon HTTP API (127.0.0.1:5903) thin wrapper.
+ * webui 와 동일 데이터 흐름 — 단일 진실.
  */
 import { execSync, spawnSync } from "node:child_process";
 import path from "node:path";
+import readline from "node:readline";
 import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
 
@@ -47,15 +56,39 @@ function runScript(scriptName) {
 }
 
 function help() {
-  console.log(`${bold("mulsok-client")} · mulsok-traders 데스크톱 클라이언트
+  console.log(`${bold("mulsok-client")} · mulsok-traders 데스크톱 클라이언트 (headless / SSH 지원)
+
+  ${bold("데몬 lifecycle")}
+    install                    데몬 등록 + 가동 (npm install 시 자동)
+    uninstall                  데몬 제거 (데이터 보존)
+    update                     npm update + 데몬 재시작
+    status [--json]            daemon · 인증 · 설정 · 계좌 · 감시자 · readiness
+    logs                       로그 실시간 tail
+
+  ${bold("config — daemon API thin wrapper (webui 없이 운영)")}
+    config show                현재 설정 (마스킹 출력)
+    config token [<TOKEN>]     디바이스 인증 (인자 없으면 stdin 비밀 입력)
+    config llm <provider>      LLM 설정 [--api-key=K] [--model=M]
+                               providers: claude-cli·anthropic·openai·gemini
+    config broker kiwoom       키움 등록
+                               --app-key=K --app-secret=S [--demo|--live]
+    config subs list           구독 목록
+    config subs add <slug>     구독 추가
+    config subs remove <slug>  구독 제거
 
-  ${bold("명령")}
-    install      데몬 등록 + 가동 (npm install 시 자동 실행)
-    uninstall    데몬 제거 (데이터 보존)
-    status       launchctl 상태 + readiness 6 게이트
-    logs         로그 실시간 tail
-    update       npm update + 데몬 재시작
-    help         이 메시지
+  ${bold("운영 명령")}
+    prepare                    시세 데이터 download (첫 install 5~10분 · progress 표시)
+    safety status              현재 safety 상태
+    safety halt [reason]       긴급 정지
+    safety resume              정상 가동 재개
+    cycle <slug>               수동 cycle (7~13분 · 분석 후 요약)
+    diary <slug> [--date=]     일기 본문 (markdown ANSI · default 오늘)
+    diary <slug> --list        일기 목록 (날짜 + 길이 + 발췌)
+    journal [--days=7]         최근 이벤트 timeline [--tail=10]
+    watchers [--persona=slug]  active 감시자 표
+    share dump                 (admin) 시세 SQLite VACUUM INTO + gzip dump
+    share publish-postgres     (admin) SQLite → Supabase Postgres bulk upsert
+                               [--universe-only|--candles-only]
 
   ${bold("운영 위치")}
     설정/데이터: ~/.mulsok-traders/
@@ -67,34 +100,126 @@ function help() {
 `);
 }
 
-function status() {
-  if (!isMac()) {
-    console.log(yellow("⚠ macOS 외 OS 는 미지원 (Windows/Linux 추후)"));
+async function status(asJson = false) {
+  // 데이터 수집 — daemon 응답 없으면 부분 결과만
+  let daemonState = null;
+  if (isMac()) {
+    try {
+      const out = execSync(`launchctl list | grep ${LABEL} || true`).toString().trim();
+      daemonState = out || null;
+    } catch { /* ignore */ }
+  }
+
+  let health = null;
+  let identity = null;
+  let cfg = null;
+  let watchers = null;
+  let account = null;
+  let readiness = null;
+  try { health = await (await fetch(`${API_BASE}/api/health`)).json(); } catch { /* ignore */ }
+  if (health) {
+    try { identity = await (await fetch(`${API_BASE}/api/me/identity`)).json(); } catch { /* ignore */ }
+    try { cfg = await (await fetch(`${API_BASE}/api/config`)).json(); } catch { /* ignore */ }
+    try { watchers = await (await fetch(`${API_BASE}/api/watchers`)).json(); } catch { /* ignore */ }
+    try { account = await (await fetch(`${API_BASE}/api/account/status`)).json(); } catch { /* ignore */ }
+    try { readiness = await (await fetch(`${API_BASE}/api/readiness`)).json(); } catch { /* ignore */ }
+  }
+
+  if (asJson) {
+    console.log(JSON.stringify({
+      daemon: { running: !!daemonState, line: daemonState },
+      health, identity,
+      config: cfg?.config,
+      watchers: watchers?.stats,
+      account: account?.deposit && account?.holdings ? {
+        deposit: account.deposit,
+        holdings: { count: account.holdings.count, totalEval: account.holdings.totalEvalKrw, pnlPct: account.holdings.totalPnlPct },
+      } : null,
+      readiness: readiness ? { ready: readiness.ready, score: readiness.score } : null,
+    }, null, 2));
     return;
   }
-  console.log(bold("▶ 데몬 상태"));
-  try {
-    const out = execSync(`launchctl list | grep ${LABEL} || true`).toString().trim();
-    console.log(out || "  (등록 안 됨)");
-  } catch (e) {
-    console.log(`  launchctl 조회 실패: ${e.message}`);
+
+  // ── 사람 친화 출력 ──────────────────────────────────────
+  console.log(bold("▶ daemon"));
+  if (daemonState) {
+    const [pid, _exit, _label] = daemonState.split(/\s+/);
+    console.log(`  ${green("● running")} · PID ${pid}`);
+  } else if (isMac()) {
+    console.log(`  ${red("○ stopped")} · launchctl 등록 안 됨 (mulsok-client install 권장)`);
+  } else {
+    console.log(`  ${yellow("⚠ macOS 외 — launchctl 미지원")}`);
   }
 
-  console.log(`\n${bold("▶ 헬스체크")}`);
-  try {
-    const r = execSync(`curl -sf "${HEALTH_URL}"`).toString();
-    console.log(green(`  ✓ ${HEALTH_URL}`));
-    console.log(`  ${r.slice(0, 200)}`);
-  } catch {
-    console.log(red(`  ✗ ${HEALTH_URL} 응답 없음`));
+  if (!health) {
+    console.log(`  ${red("✗ HTTP 응답 없음")} (${API_BASE}/api/health)`);
+    console.log("  → mulsok-client logs 로 stderr 확인 권장");
+    return;
   }
+  console.log(`  ${green(health.service)} v${health.version} · node ${health.node}`);
 
-  console.log(`\n${bold("▶ readiness")}`);
-  try {
-    const r = execSync(`curl -s "${READINESS_URL}" | python3 -m json.tool 2>/dev/null || curl -s "${READINESS_URL}"`).toString();
-    console.log(r);
-  } catch {
-    console.log("  (조회 실패)");
+  // 인증
+  console.log(`\n${bold("▶ 인증")}`);
+  if (identity?.userEmail) {
+    const adminBadge = identity.isAdmin ? ` ${yellow("[관리자]")}` : "";
+    console.log(`  ${green("✓")} ${identity.userEmail}${adminBadge} (user ${identity.userId})`);
+  } else if (identity?.hasToken && !identity?.lastAuthenticated) {
+    console.log(`  ${red("✗")} server 가 토큰 거부 — 새 토큰 발급 필요`);
+  } else if (identity?.hasToken) {
+    console.log(`  ${yellow("⏳")} 인증 중 (server 응답 대기)`);
+  } else {
+    console.log(`  ${yellow("○")} 인증되지 않음 — mulsok-client config token <T>`);
+  }
+
+  // LLM / broker / safety 한 줄
+  const c = cfg?.config ?? {};
+  const llm = c.llm ?? {};
+  const broker = c.broker ?? {};
+  console.log(`\n${bold("▶ 설정")}`);
+  const llmStr = llm.provider
+    ? `${llm.provider}${llm.claudeCli?.model ? ` (${llm.claudeCli.model})` : ""}`
+    : yellow("(미설정)");
+  const brokerStr = broker.kind
+    ? `${broker.kind} · ${broker.isDemo ? yellow("모의") : red("실거래")}`
+    : yellow("(미설정)");
+  console.log(`  ${pad("LLM", 10)} ${llmStr}`);
+  console.log(`  ${pad("broker", 10)} ${brokerStr}`);
+  console.log(`  ${pad("구독", 10)} ${(c.subscriptions ?? []).join(", ") || yellow("(없음)")}`);
+  console.log(`  ${pad("safety", 10)} ${c.halted ? red("긴급 정지") : green("정상")}`);
+
+  // 계좌
+  if (account?.deposit?.ok) {
+    console.log(`\n${bold("▶ 계좌")}`);
+    const fmtKrw = (n) => n >= 10000 ? `${Math.round(n / 10_000).toLocaleString("ko-KR")}만원` : `${(n ?? 0).toLocaleString("ko-KR")}원`;
+    console.log(`  ${pad("예수금", 10)} ${fmtKrw(account.deposit.totalDepositKrw ?? 0)}`);
+    console.log(`  ${pad("가용현금", 10)} ${fmtKrw(account.deposit.availableKrw ?? 0)}`);
+    if (account.holdings?.count > 0) {
+      const pnl = account.holdings.totalPnlPct ?? 0;
+      const pnlColor = pnl > 0 ? green : pnl < 0 ? red : (s) => s;
+      console.log(`  ${pad("보유종목", 10)} ${account.holdings.count}건 · 평가 ${fmtKrw(account.holdings.totalEvalKrw)} · ${pnlColor((pnl >= 0 ? "+" : "") + pnl.toFixed(2) + "%")}`);
+    }
+  }
+
+  // 감시자
+  if (watchers) {
+    console.log(`\n${bold("▶ 감시자")}`);
+    const s = watchers.stats ?? {};
+    console.log(`  ${pad("active", 10)} ${s.active ?? 0}건`);
+    if (s.byPersona) {
+      const parts = Object.entries(s.byPersona).map(([k, v]) => `${k} ${v}`);
+      if (parts.length > 0) console.log(`  ${pad("by persona", 10)} ${parts.join(" · ")}`);
+    }
+    const pf = watchers.priceFeed;
+    if (pf) console.log(`  ${pad("priceFeed", 10)} ${pf.running ? green("running") : red("stopped")} · ${pf.stocks ?? 0} stocks`);
+  }
+
+  // readiness
+  if (readiness?.score) {
+    console.log(`\n${bold("▶ readiness")} ${readiness.ready ? green("✓ ready") : yellow(`${readiness.score.ok}/${readiness.score.total_blocking}`)}`);
+    for (const item of readiness.items ?? []) {
+      const icon = item.status === "ok" ? green("✓") : item.status === "fail" ? red("✗") : yellow("○");
+      console.log(`  ${icon} ${pad(item.label, 24)} ${item.detail ?? ""}`);
+    }
   }
 }
 
@@ -125,6 +250,437 @@ function update() {
   }
 }
 
+/* ============================================================
+   config subcommands · daemon HTTP API thin wrapper (Phase 1)
+   ============================================================ */
+
+const API_BASE = "http://127.0.0.1:5903";
+
+async function apiGet(p) {
+  try {
+    const r = await fetch(`${API_BASE}${p}`);
+    if (!r.ok) throw new Error(`HTTP ${r.status}`);
+    return await r.json();
+  } catch (e) {
+    console.error(red(`✗ daemon 응답 없음 (${p}) — 데몬이 가동 중인지 확인: mulsok-client status`));
+    console.error(red(`  ${e.message}`));
+    process.exit(2);
+  }
+}
+
+async function apiPost(p, body) {
+  try {
+    const r = await fetch(`${API_BASE}${p}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body ?? {}),
+    });
+    const j = await r.json().catch(() => ({}));
+    if (!r.ok) {
+      console.error(red(`✗ ${p} HTTP ${r.status}`));
+      if (j?.error) console.error(red(`  ${j.error}`));
+      process.exit(2);
+    }
+    return j;
+  } catch (e) {
+    console.error(red(`✗ daemon 응답 없음 (${p})`));
+    console.error(red(`  ${e.message}`));
+    process.exit(2);
+  }
+}
+
+/** stdin 비밀 입력 (echo off 가까운 경험 — Node 표준 readline 한계로 마지막 줄만 가림) */
+function readSecretLine(prompt) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+    // echo off — input 마다 line 위에 덮어쓰기 (제한적)
+    rl._writeToOutput = (s) => {
+      if (s.includes(prompt)) process.stdout.write(s);
+      else process.stdout.write("*");
+    };
+  });
+}
+
+function maskSecret(v, keep = 4) {
+  if (typeof v !== "string" || v.length <= keep) return v ? "***" : "(없음)";
+  return `${v.slice(0, keep)}${"*".repeat(Math.max(4, v.length - keep))}`;
+}
+
+function pad(s, w) {
+  s = String(s);
+  return s + " ".repeat(Math.max(0, w - [...s].length));
+}
+
+function configShow(json) {
+  const cfg = json.config ?? {};
+  const auth = cfg.auth ?? {};
+  const llm = cfg.llm ?? {};
+  const broker = cfg.broker ?? {};
+  const subs = cfg.subscriptions ?? [];
+
+  const rows = [
+    ["인증 user", auth.userEmail ? green(auth.userEmail) : yellow("(미인증)")],
+    ["user_id", auth.userId ?? yellow("—")],
+    ["device token", maskSecret(auth.deviceToken)],
+    ["LLM provider", llm.provider ?? yellow("(미설정)")],
+    ["LLM model", llm.claudeCli?.model ?? llm.anthropic?.model ?? llm.openai?.model ?? llm.gemini?.model ?? "—"],
+    ["broker", broker.kind ?? yellow("(미설정)")],
+    ["broker key", maskSecret(broker.appKey)],
+    ["broker secret", maskSecret(broker.appSecret)],
+    ["broker mode", broker.kind === "kiwoom" ? (broker.isDemo ? yellow("모의") : red("실거래")) : "—"],
+    ["구독 수", String(subs.length)],
+    ["구독 slugs", subs.length > 0 ? subs.join(", ") : yellow("(없음)")],
+    ["safety", cfg.halted ? red("긴급 정지") : green("정상")],
+  ];
+  console.log(bold("▶ 현재 설정 (마스킹)"));
+  for (const [k, v] of rows) console.log(`  ${pad(k, 14)} ${v}`);
+}
+
+function parseFlags(args) {
+  const flags = {};
+  const rest = [];
+  for (const a of args) {
+    if (a.startsWith("--")) {
+      const eq = a.indexOf("=");
+      if (eq > 0) flags[a.slice(2, eq)] = a.slice(eq + 1);
+      else flags[a.slice(2)] = true;
+    } else rest.push(a);
+  }
+  return { flags, rest };
+}
+
+async function configToken(args) {
+  let token = args[0];
+  if (!token) {
+    token = await readSecretLine("디바이스 토큰 입력 (mtd_…) → ");
+  }
+  if (!token) {
+    console.error(red("✗ 토큰이 비어있습니다"));
+    process.exit(1);
+  }
+  if (!token.startsWith("mtd_")) {
+    console.error(yellow(`⚠ 토큰이 'mtd_' 로 시작하지 않습니다 (입력: ${maskSecret(token)})`));
+  }
+  console.log("토큰 등록 중 · server ping 대기...");
+  const r = await apiPost("/api/config", { auth: { deviceToken: token } });
+  void r;
+  // 인증 결과 확인
+  const id = await apiGet("/api/me/identity");
+  if (id.userEmail) {
+    console.log(green(`✓ 인증 성공: ${id.userEmail} (user ${id.userId})`));
+  } else if (id.hasToken && !id.lastAuthenticated) {
+    console.error(red("✗ server 가 토큰을 거부했습니다 — 새 토큰 발급 필요"));
+    process.exit(1);
+  } else {
+    console.log(yellow("⏳ 인증 진행 중 — `mulsok-client config show` 로 다시 확인"));
+  }
+}
+
+async function configLlm(args) {
+  const { flags, rest } = parseFlags(args);
+  const provider = rest[0];
+  const valid = ["claude-cli", "anthropic", "openai", "gemini"];
+  if (!provider || !valid.includes(provider)) {
+    console.error(red(`✗ provider 지정: ${valid.join(" / ")}`));
+    process.exit(1);
+  }
+  const patch = { llm: { provider } };
+  // provider 별 config 키
+  if (provider === "claude-cli") {
+    patch.llm.claudeCli = { model: flags.model ?? "sonnet" };
+    if (flags["binary-path"]) patch.llm.claudeCli.binaryPath = flags["binary-path"];
+  } else {
+    patch.llm[provider] = {};
+    if (flags["api-key"]) patch.llm[provider].apiKey = flags["api-key"];
+    if (flags.model) patch.llm[provider].model = flags.model;
+  }
+  await apiPost("/api/config", patch);
+  console.log(green(`✓ LLM provider 설정: ${provider}${flags.model ? ` (${flags.model})` : ""}`));
+}
+
+async function configBroker(args) {
+  const { flags, rest } = parseFlags(args);
+  const kind = rest[0];
+  if (kind !== "kiwoom") {
+    console.error(red("✗ 현재 지원: kiwoom 만 (KIS 추후)"));
+    process.exit(1);
+  }
+  const appKey = flags["app-key"];
+  const appSecret = flags["app-secret"];
+  if (!appKey || !appSecret) {
+    console.error(red("✗ --app-key=K --app-secret=S 필수"));
+    process.exit(1);
+  }
+  const isDemo = !flags.live;     // default = demo · --live 면 실거래
+  const patch = { broker: { kind: "kiwoom", appKey, appSecret, isDemo } };
+  await apiPost("/api/config", patch);
+  console.log(green(`✓ 키움 등록 (${isDemo ? "모의투자" : red("⚠ 실거래")})`));
+}
+
+async function configSubs(args) {
+  const sub = args[0];
+  if (sub === "list" || !sub) {
+    const r = await apiGet("/api/subscriptions");
+    const list = r.subscriptions ?? [];
+    console.log(bold(`▶ 구독 (${list.length}명)`));
+    if (list.length === 0) console.log("  (없음)");
+    else for (const s of list) console.log(`  · ${s}`);
+    return;
+  }
+  if (sub === "add" || sub === "remove") {
+    const slug = args[1];
+    if (!slug) {
+      console.error(red(`✗ slug 인자 필요: mulsok-client config subs ${sub} <slug>`));
+      process.exit(1);
+    }
+    const cur = await apiGet("/api/config");
+    const list = new Set(cur.config?.subscriptions ?? []);
+    if (sub === "add") list.add(slug);
+    else list.delete(slug);
+    await apiPost("/api/config", { subscriptions: [...list] });
+    console.log(green(`✓ ${sub === "add" ? "추가" : "제거"}: ${slug} · 총 ${list.size}명`));
+    return;
+  }
+  console.error(red(`✗ 알 수 없는 subs 명령: ${sub}`));
+  console.error("  사용: list / add <slug> / remove <slug>");
+  process.exit(1);
+}
+
+/* ============================================================
+   운영 명령 (Phase 3) — cycle · diary · journal · watchers · safety
+   ============================================================ */
+
+async function safetyCmd(args) {
+  const sub = args[0];
+  if (sub === "status" || !sub) {
+    const r = await apiGet("/api/safety");
+    console.log(`safety: ${r.halted ? red("긴급 정지") : green("정상 가동")}`);
+    if (r.reason) console.log(`reason: ${r.reason}`);
+    return;
+  }
+  if (sub === "halt") {
+    const reason = args.slice(1).join(" ") || "manual cli";
+    await apiPost("/api/safety/halt", { reason });
+    console.log(red(`✗ 긴급 정지 (reason: ${reason})`));
+    return;
+  }
+  if (sub === "resume") {
+    await apiPost("/api/safety/resume");
+    console.log(green("✓ 정상 가동 재개"));
+    return;
+  }
+  console.error(red(`✗ 알 수 없는 safety 명령: ${sub}`));
+  console.error("  사용: status / halt [reason] / resume");
+  process.exit(1);
+}
+
+async function cycleCmd(args) {
+  const slug = args[0];
+  if (!slug) {
+    console.error(red("✗ slug 인자 필요: mulsok-client cycle <slug>"));
+    process.exit(1);
+  }
+  console.log(`→ ${slug} cycle 시작 · 분석 시간 7~13분 (claude-cli sonnet)`);
+  const t0 = Date.now();
+  const r = await apiPost(`/api/personas/${slug}/cycle`, {});
+  const sec = Math.round((Date.now() - t0) / 1000);
+  if (!r.ok) {
+    console.error(red(`✗ cycle 실패 (${sec}s): ${r.error ?? "unknown"}`));
+    process.exit(1);
+  }
+  console.log(green(`✓ cycle 완료 (${sec}s)`));
+  if (r.summary) {
+    const lines = r.summary.replace(/<state_update>[\s\S]*?<\/state_update>/g, "").trim().split("\n");
+    const head = lines.slice(0, 12).join("\n");
+    console.log(`\n${bold("요약")}\n${head}`);
+    if (lines.length > 12) console.log(yellow(`\n  (+${lines.length - 12} more · 풀 본문은 mulsok-client diary ${slug})`));
+  }
+}
+
+async function diaryCmd(args) {
+  const { flags, rest } = parseFlags(args);
+  const slug = rest[0];
+  if (!slug) {
+    console.error(red("✗ slug 인자 필요: mulsok-client diary <slug> [--date=YYYY-MM-DD]"));
+    process.exit(1);
+  }
+  if (flags.list) {
+    const r = await apiGet(`/api/diary/${slug}/list?limit=${flags.limit ?? 30}`);
+    console.log(bold(`▶ ${slug} 일기 (${(r.diaries ?? []).length}편)`));
+    for (const d of (r.diaries ?? [])) {
+      console.log(`  ${pad(d.date, 12)} ${pad(`${d.bodyLength}자`, 8)} ${d.excerpt.replace(/^#[^\n]*\n+/, "").slice(0, 60).replace(/\n/g, " ")}…`);
+    }
+    return;
+  }
+  const date = flags.date ?? new Date(Date.now() + 9 * 3600_000).toISOString().slice(0, 10);
+  const r = await apiGet(`/api/diary/${slug}?date=${date}`);
+  if (!r.ok) {
+    console.error(red(`✗ ${date} 의 ${slug} 일기 없음 — mulsok-client diary ${slug} --list`));
+    process.exit(1);
+  }
+  // 가벼운 markdown → ANSI: # = bold, ** = bold, > = quote, --- = hr
+  const body = r.body
+    .replace(/^# (.+)$/gm, (_m, t) => `\n${bold(t)}\n`)
+    .replace(/^## (.+)$/gm, (_m, t) => `\n${bold(yellow(t))}\n`)
+    .replace(/^### (.+)$/gm, (_m, t) => `${bold(t)}`)
+    .replace(/\*\*(.+?)\*\*/g, (_m, t) => bold(t))
+    .replace(/^> (.+)$/gm, (_m, t) => `  ${yellow("│")} ${t}`)
+    .replace(/^---$/gm, "─".repeat(60));
+  console.log(body);
+}
+
+async function journalCmd(args) {
+  const { flags } = parseFlags(args);
+  const days = flags.days ?? 7;
+  const limit = parseInt(flags.tail ?? "10", 10);
+  const r = await apiGet(`/api/journal/events?days=${days}`);
+  const events = (r.events ?? []).slice(-limit).reverse();
+  console.log(bold(`▶ 최근 ${events.length}건 이벤트 (최근 ${days}일)`));
+  for (const e of events) {
+    const ts = new Date(e.timestamp).toLocaleString("ko-KR", { month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" });
+    const type = pad(e.eventType ?? "?", 18);
+    const persona = pad(e.personaSlug ?? "—", 8);
+    const meta = e.symbolName || (e.meta && e.meta.intent) || "";
+    console.log(`  ${ts}  ${type}  ${persona}  ${meta}`);
+  }
+}
+
+async function watchersCmd(args) {
+  const { flags } = parseFlags(args);
+  const personaQ = flags.persona ? `?personaSlug=${flags.persona}&activeOnly=true` : "?activeOnly=true";
+  const r = await apiGet(`/api/watchers${personaQ}`);
+  const list = r.watchers ?? [];
+  console.log(bold(`▶ active watchers (${list.length}건)`));
+  for (const w of list) {
+    const type = pad(w.spec?.condition?.type ?? "?", 6);
+    const persona = pad(w.personaSlug ?? "—", 8);
+    const intent = (w.spec?.intent ?? "").slice(0, 70);
+    console.log(`  ${pad(w.id, 14)} ${type} ${persona} ${intent}`);
+  }
+}
+
+async function prepareCmd() {
+  console.log("→ 시세 데이터 준비 시작 (첫 install 5~10분 · 매일 갱신은 수 초)");
+  // 1) start
+  const start = await apiPost("/api/prepare/start", {});
+  if (!start.started) {
+    console.log(yellow("⚠ 이미 진행 중 — 같은 진행 polling"));
+  }
+
+  // 2) polling (1초 간격)
+  let lastPages = -1;
+  let lastReturned = -1;
+  while (true) {
+    await new Promise((r) => setTimeout(r, 1000));
+    const s = await apiGet("/api/prepare/status");
+
+    // running 인 동안 progress 표시 (변화 있을 때만)
+    if (s.running) {
+      const u = s.universe.done ? green(`✓ universe ${s.universe.count}`) : "⏳ universe";
+      const cP = s.candles.pages;
+      const cR = s.candles.returned;
+      if (cP !== lastPages || cR !== lastReturned) {
+        const elapsed = Math.round((Date.now() - s.startedAt) / 1000);
+        process.stdout.write(
+          `\r  ${u}  ·  candles page ${cP} · ${cR.toLocaleString()} row · ${elapsed}s 경과    `,
+        );
+        lastPages = cP;
+        lastReturned = cR;
+      }
+      continue;
+    }
+
+    // 종료 (running=false)
+    process.stdout.write("\n");
+    if (s.ok) {
+      const sec = Math.round(((s.finishedAt ?? 0) - (s.startedAt ?? 0)) / 1000);
+      console.log(green(`✓ 준비 완료 (${sec}s · ${(sec / 60).toFixed(1)}분)`));
+      console.log(`  ${pad("universe", 12)} ${s.universe.count.toLocaleString()} 종목`);
+      console.log(`  ${pad("candles", 12)} ${s.candles.returned.toLocaleString()} row · ${s.candles.pages} page`);
+      console.log("\n이제 mulsok-client cycle <slug> 가능합니다");
+    } else {
+      console.error(red(`✗ 실패: ${s.error ?? "unknown"}`));
+      process.exit(1);
+    }
+    return;
+  }
+}
+
+async function shareCmd(args) {
+  const sub = args[0];
+  if (sub === "dump" || !sub) {
+    console.log("→ admin 시세 스냅샷 export · VACUUM INTO + gzip (수 분 소요 가능)");
+    const t0 = Date.now();
+    const r = await apiPost("/api/admin/share/dump", {});
+    const sec = Math.round((Date.now() - t0) / 1000);
+    if (!r.ok) {
+      console.error(red(`✗ 실패 (${sec}s): ${r.error ?? "unknown"}`));
+      process.exit(1);
+    }
+    const rawMb = ((r.bytes ?? 0) / 1e6).toFixed(1);
+    const gzMb = ((r.bytesGzip ?? 0) / 1e6).toFixed(1);
+    const compPct = (100 - (r.compressionRatio ?? 0) * 100).toFixed(0);
+    console.log(green(`✓ 완료 (${sec}s)`));
+    console.log(`  ${pad("path", 10)} ${r.path}`);
+    console.log(`  ${pad("raw", 10)} ${rawMb}MB`);
+    console.log(`  ${pad("gzip", 10)} ${gzMb}MB (${compPct}% 압축)`);
+    return;
+  }
+  if (sub === "publish-postgres") {
+    const { flags } = parseFlags(args.slice(1));
+    const body = {};
+    if (flags["universe-only"]) body.universeOnly = true;
+    if (flags["candles-only"]) body.candlesOnly = true;
+    console.log("→ admin SQLite → Supabase Postgres publish · 30~60분 소요 (10M+ row chunk upsert)");
+    console.log("  진행 로그는 mulsok-client logs 로 실시간 확인");
+    const t0 = Date.now();
+    const r = await apiPost("/api/admin/share/publish-postgres", body);
+    const sec = Math.round((Date.now() - t0) / 1000);
+    if (!r.ok) {
+      console.error(red(`✗ 실패 (${sec}s): ${r.error ?? "unknown"}`));
+      process.exit(1);
+    }
+    console.log(green(`✓ 완료 (${sec}s · ${(sec / 60).toFixed(1)}분)`));
+    console.log(`  ${pad("universe", 10)} ${(r.universeRows ?? 0).toLocaleString()} rows`);
+    console.log(`  ${pad("candles", 10)} ${(r.candleRows ?? 0).toLocaleString()} rows`);
+    return;
+  }
+  console.error(red(`✗ 알 수 없는 share 명령: ${sub}`));
+  console.error("  사용: dump · publish-postgres [--universe-only|--candles-only]");
+  process.exit(1);
+}
+
+async function configCmd(args) {
+  const sub = args[0];
+  switch (sub) {
+    case "show":
+    case undefined:
+      configShow(await apiGet("/api/config"));
+      return;
+    case "token":
+      await configToken(args.slice(1));
+      return;
+    case "llm":
+      await configLlm(args.slice(1));
+      return;
+    case "broker":
+      await configBroker(args.slice(1));
+      return;
+    case "subs":
+    case "subscriptions":
+      await configSubs(args.slice(1));
+      return;
+    default:
+      console.error(red(`✗ 알 수 없는 config 명령: ${sub}`));
+      console.error("  사용: show / token / llm / broker / subs");
+      process.exit(1);
+  }
+}
+
 switch (cmd) {
   case "install":
     if (!isMac()) {
@@ -141,7 +697,7 @@ switch (cmd) {
     runScript("uninstall-daemon.sh");
     break;
   case "status":
-    status();
+    await status(process.argv.includes("--json"));
     break;
   case "logs":
     logs();
@@ -149,6 +705,30 @@ switch (cmd) {
   case "update":
     update();
     break;
+  case "config":
+    await configCmd(process.argv.slice(3));
+    break;
+  case "safety":
+    await safetyCmd(process.argv.slice(3));
+    break;
+  case "cycle":
+    await cycleCmd(process.argv.slice(3));
+    break;
+  case "diary":
+    await diaryCmd(process.argv.slice(3));
+    break;
+  case "journal":
+    await journalCmd(process.argv.slice(3));
+    break;
+  case "watchers":
+    await watchersCmd(process.argv.slice(3));
+    break;
+  case "share":
+    await shareCmd(process.argv.slice(3));
+    break;
+  case "prepare":
+    await prepareCmd();
+    break;
   case "help":
   case undefined:
     help();