@mulsok/traders-client 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,80 @@
+# Changelog
+
+All notable changes to `@mulsok/traders-client`.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) ·
+versioning [SemVer](https://semver.org/).
+
+## [0.2.1] — 2026-05-10
+
+Onboarding UX hotfix — 토큰 등록 후 web dashboard 의 Step 4 (broker/llm)
+진입까지 1시간 polling 대기하던 문제 근본 해결.
+
+### Fixed
+- **server-sync 의 self-bootstrap** — 첫 ping 에서 user_id 받자마자 즉시
+  한 번 더 self-recurse 해서 readiness payload 동봉한 두 번째 ping trigger.
+  이전엔 다음 1시간 cron 까지 wait 했음. recursion depth 1 cap.
+- `/api/health` 의 `version` 이 "0.0.0" hard-coded 였던 display bug —
+  runtime 에 package.json 에서 read.
+
+### 영향
+- 신규 사용자: `mulsok-client config token <T>` 직후 5초 안에 dashboard
+  Step 4 자동 진입 (이전 1시간 wait → 즉시).
+- 기존 사용자: 변경 없음 (cfg.auth.userId 이미 채워진 상태).
+
+## [0.2.0] — 2026-05-10
+
+Phase 5e (ADR-016) — admin SQLite ↔ Supabase Postgres ↔ client SQLite 의
+시세 동기화 인프라. 신규 사용자가 키움 호출 없이 admin 이 publish 한
+시세를 download 받아 페르소나 분석 가능.
+
+### Added
+- `mulsok-client prepare` — 시세 데이터 download 진행률 CLI (5~10분 첫 install)
+- `mulsok-client share dump` — admin SQLite VACUUM INTO + gzip backup
+- `mulsok-client share publish-postgres` — admin SQLite → Supabase Postgres bulk upsert
+- WebUI `PreparePage` — 첫 진입 자동 진행 화면 (readiness 미충족 감지)
+- daemon startup catch-up — 마지막 sync/publish > 6h 면 즉시 fire-and-forget trigger
+- daemon publish cron — 매일 16:35 KST 자동 sync + publish (admin only · 평일)
+- daemon market-pull periodic — 매시간 server-sync 시 vercel `/api/market/*` 에서 incremental pull
+
+### Changed
+- 키움 fetch 에 30s timeout (AbortController) — fetch + body read 둘 다 보호. rate limiter chain hang 차단.
+- `getDailyChartDeep` 의 `maxRounds` 동적 계산 (`Math.max(6, ⌈totalDays/100⌉)`) — 5,000봉 (20년) backfill 가능
+- universe sync 의 resume 최적화 — 이미 deep 한 종목 skip
+- `/api/local/sync` 의 `onProgress` console.log — 진행 가시화
+- readiness `data-prepared` 항목 detail 에 prepare 진행 hint
+- universe-sync cron 자체는 SPEC-27 ADR-012 로 폐기 유지 — publish-cron 안에서 universe-sync 먼저 실행하도록 통합
+
+### Fixed
+- vercel `/api/market/candles` cursor pagination 의 date 경계 안전 — `last_date` row 들 drop 후 `next_since` 응답 (silent data loss 방지)
+
+### Infra
+- `supabase/migrations/0033_market_schema.sql`
+  - `market.{universe,daily_candles,sync_meta}` 테이블 + RLS (service_role 전용)
+  - `pgrst.db_schemas` 에 `market` 추가 (PostgREST 노출)
+  - `pgrst.db_max_rows = 250000` (default 1,000 의 server-side cap 해소)
+
+### Dependencies
+- 추가: `@supabase/supabase-js@^2.105.4`
+
+### Notes
+- 첫 install 시 `mulsok-client prepare` 또는 webui 진입 시 자동으로 시세 데이터 download
+- 매시간 background market-pull 로 자동 갱신 (수 초 incremental)
+- admin 만 publish 권한 — `SUPABASE_URL` · `SUPABASE_SERVICE_ROLE_KEY` 환경변수 필요
+
+## [0.1.1] — 2026-05-09
+
+### Added
+- backfill resume 최적화 — 이미 candleDays 이상 보유한 종목은 skip
+- 보통주 우선 정렬 (D1) — screener 가 reject 하는 비보통주 후순위 처리
+
+### Fixed
+- ETF prefix 보강 (TREX · 파워 · KoAct · 마스터 · 히어로즈)
+- `screener.maxPeriod` 계산 누락으로 candles 부족 영구 fail
+
+### Removed
+- dante 페르소나 artifacts 제거 — 너울 단독 운영 복원
+
+## [0.1.0]
+
+Initial public release.

package/README.md

@@ -6,6 +6,10 @@ mulsok-traders 데스크톱 클라이언트 — 한국 주식 AI 자율 트레
 
 > **베타 1라운드** · macOS only · claude CLI (Claude Code) 권장
 
+> 🖥 → ⌨ **SSH · 헤드리스 환경 사용자**: 이 패키지의 모든 운영을 webui 없이
+> CLI 만으로 진행할 수 있습니다. 단계별 가이드 →
+> [mulsok-traders.vercel.app/guide?mode=cli](https://mulsok-traders.vercel.app/guide?mode=cli)
+
 ## 설치
 
 ```bash
@@ -39,14 +43,47 @@ claude --version  # 2.x 이상 (https://claude.com/claude-code)
 
 ## 명령어
 
+CLI 가 모든 운영 명령을 제공합니다 — webui 없이도 헤드리스 / SSH 환경에서 daemon 을 완전히 제어할 수 있습니다.
+
+### Daemon lifecycle
+
+```bash
+mulsok-client status [--json]  # daemon · 인증 · 설정 · 계좌 · 감시자 · readiness
+mulsok-client logs              # 로그 실시간 tail (Ctrl+C 종료)
+mulsok-client update            # npm update + daemon 재시작
+mulsok-client uninstall         # 데몬 제거 (데이터 보존)
+mulsok-client help              # 도움말
+```
+
+### 설정 (config — webui 우회)
+
+```bash
+mulsok-client config show                       # 현재 설정 (마스킹 표 출력)
+mulsok-client config token <T>                  # 디바이스 인증 (인자 없으면 stdin 비밀 입력)
+mulsok-client config llm <provider> [--api-key=K] [--model=M]
+                                                # provider: claude-cli·anthropic·openai·gemini
+mulsok-client config broker kiwoom \
+        --app-key=K --app-secret=S [--demo|--live]
+mulsok-client config subs list                  # 구독 목록
+mulsok-client config subs add <slug>            # 구독 추가
+mulsok-client config subs remove <slug>         # 구독 제거
+```
+
+### 운영
+
 ```bash
-mulsok-client status     # 데몬 상태 + readiness
-mulsok-client logs       # 로그 실시간 tail
-mulsok-client update     # 최신 버전 받기 + 자동 재시작
-mulsok-client uninstall  # 데몬 제거 (데이터 보존)
-mulsok-client help       # 도움말
+mulsok-client safety status                     # 현재 safety 상태
+mulsok-client safety halt [reason]              # 긴급 정지
+mulsok-client safety resume                     # 정상 가동 재개
+mulsok-client cycle <slug>                      # 수동 cycle (7~13분 · 분석 후 요약)
+mulsok-client diary <slug> [--date=YYYY-MM-DD]  # 일기 본문 (markdown ANSI · default 오늘)
+mulsok-client diary <slug> --list [--limit=30]  # 일기 목록 (날짜·길이·발췌)
+mulsok-client journal [--days=7] [--tail=10]    # 최근 이벤트 timeline
+mulsok-client watchers [--persona=slug]         # active 감시자 표
 ```
 
+> 모든 명령은 **daemon HTTP API (127.0.0.1:5903) thin wrapper** 입니다. webui 와 동일한 데이터 흐름이라 인증 토큰·종목 정보 등은 daemon 안에 그대로 보관되며 외부로 송신되지 않습니다.
+
 ## 업데이트
 
 ```bash