@mulsok/traders-client 0.1.0

package/dist/server/index.js

@@ -0,0 +1,316 @@
+/**
+ * Client entrypoint · Fastify + static web serve + 브라우저 자동 오픈.
+ * ADR-008 · 사용자 PC 에서만 돌아감. 서버 송신 데이터는 익명 집계 뿐.
+ *
+ * 환경 변수 로드 (loadConfig 보다 먼저):
+ *   1. ~/.mulsok-traders/.env (사용자별 · 운영 환경 우선)
+ *   2. apps/client 의 .env (개발 / 보조)
+ * 둘 다 옵셔널. 없으면 OS env / launchd plist EnvironmentVariables 사용.
+ */
+import { config as loadDotenv } from "dotenv";
+import os from "node:os";
+import path0 from "node:path";
+loadDotenv({ path: path0.join(os.homedir(), ".mulsok-traders/.env") });
+loadDotenv(); // cwd .env (override 안 함)
+import Fastify from "fastify";
+import fastifyStatic from "@fastify/static";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import open from "open";
+import { registerRoutes } from "./routes.js";
+import { getPriceFeed } from "./broker/kiwoom/index.js";
+import { getOrderTracker } from "./broker/kiwoom/order-tracker.js";
+import { getConditionWatcher } from "./watchers/condition-watcher.js";
+import { executePersonaCycle } from "./personas/persona-agent.js";
+import { startPeriodicSync, stopPeriodicSync } from "./server-sync.js";
+// SPEC-27 (ADR-012): AI 행동 cron 폐기. 시스템 watchdog 만 인프라로 유지.
+import { startWatchdog, stopWatchdog } from "./jobs/watchdog.js";
+import { logOrderSubmitted, logOrderStatus, logOrderRejected, logWatcherTriggered, logDecision, } from "./journal/trade-journal.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// ── 포트 선택 ────────────────────────────────────────────────
+const START_PORT = parseInt(process.env.CLIENT_PORT ?? "8787", 10);
+const HOST = process.env.CLIENT_HOST ?? "127.0.0.1";
+async function findPort(start) {
+    const net = await import("node:net");
+    return new Promise((resolve) => {
+        const probe = (p) => {
+            const srv = net.createServer().once("error", () => probe(p + 1)).once("listening", () => {
+                srv.close(() => resolve(p));
+            }).listen(p, HOST);
+        };
+        probe(start);
+    });
+}
+async function main() {
+    const port = await findPort(START_PORT);
+    const app = Fastify({
+        logger: {
+            level: process.env.LOG_LEVEL ?? "info",
+            transport: {
+                target: "pino-pretty",
+                options: { colorize: true, translateTime: "HH:MM:ss" },
+            },
+        },
+    });
+    // ── API 등록 ──────────────────────────────────────────────
+    await registerRoutes(app);
+    // ── PriceFeed + ConditionWatcher (Phase 3) ───────────────
+    // PriceFeed: 종목 폴링 신호기 (10s tick · 200ms stagger)
+    // ConditionWatcher: LLM wake_plan.watchers 등록 + 트리거 시 콜백
+    // 양쪽 모두 인메모리 · 프로세스 재시작 시 상태 소실 (P3 MVP)
+    getPriceFeed().start();
+    getConditionWatcher().start();
+    // OrderTracker → trade-journal 연결 (모든 상태 전이 영구 기록)
+    getOrderTracker().setStatusChangeCallback((order, prev) => {
+        if (order.status === "rejected") {
+            logOrderRejected({
+                personaSlug: order.personaSlug,
+                symbolCode: order.symbolCode,
+                side: order.side,
+                quantity: order.intendedQty,
+                priceKrw: order.intendedPriceKrw,
+                clientOrderId: order.clientOrderId,
+                error: order.error ?? "unknown",
+            });
+            return;
+        }
+        if (prev === "submitting" && order.status === "pending") {
+            logOrderSubmitted({
+                personaSlug: order.personaSlug,
+                symbolCode: order.symbolCode,
+                side: order.side,
+                quantity: order.intendedQty,
+                priceKrw: order.intendedPriceKrw,
+                brokerOrderNo: order.brokerOrderNo,
+                clientOrderId: order.clientOrderId,
+            });
+            return;
+        }
+        logOrderStatus({
+            personaSlug: order.personaSlug,
+            symbolCode: order.symbolCode,
+            side: order.side,
+            brokerOrderNo: order.brokerOrderNo,
+            clientOrderId: order.clientOrderId,
+            filledQty: order.filledQty,
+            // SPEC-9 PnL 추적: intendedPriceKrw 를 체결가 근사로 (limit 정확 · market 추정)
+            priceKrw: order.intendedPriceKrw,
+            meta: { prev, next: order.status, pollCount: order.pollCount },
+        });
+    });
+    // ConditionWatcher 트리거 → trade-journal + 페르소나 자율 재호출
+    //
+    // 흐름 (executor loop):
+    //   1. watcher 트리거 발생 (time · price · event)
+    //   2. logWatcherTriggered (trigger 발화 자체 기록)
+    //   3. SPEC-26 emergency stop 가드 (halted 시 skip + journal 기록)
+    //   4. executePersonaDecision(personaSlug, {triggeredBy}) 호출
+    //      → 해당 페르소나 재실행 · 새 wake_plan 반영 · watcher 재등록
+    //   5. 결과 (ok=true/false) journal 기록 — 사후 추적 + 자율 사이클 회귀 진단
+    //   6. 자율성 보장 (SPEC-10 정정): LLM 호출 횟수·간격 제한 X
+    //      유일한 rate limit = 키움 REST API · 무한 루프 방어 = wake-plan zod schema 의 minimum interval
+    getConditionWatcher().setGlobalTriggerCallback(async (ctx) => {
+        logWatcherTriggered({
+            personaSlug: ctx.watcher.personaSlug,
+            watcherId: ctx.watcher.id,
+            intent: ctx.watcher.spec.intent,
+            triggerData: ctx.triggerData,
+        });
+        // SPEC-26 · Emergency Stop 시 trigger callback skip + journal 기록
+        const { checkTriggerSafety } = await import("./safety.js");
+        const guard = checkTriggerSafety();
+        if (!guard.ok) {
+            console.warn(`[trigger] safety:${guard.code} → skip · ${ctx.watcher.id}`);
+            // SPEC-26 차단도 journal 에 기록 (decision eventType + llmContext 메타)
+            // 사후 분석 시 "왜 trigger 가 LLM 호출 안 했나?" 답할 수 있어야 함.
+            logDecision({
+                personaSlug: ctx.watcher.personaSlug,
+                llmContext: {
+                    followup_status: "skipped_by_safety",
+                    stage: "trigger_safety",
+                    error: `safety:${guard.code} · ${guard.reason}`,
+                    triggered_by: {
+                        watcherId: ctx.watcher.id,
+                        intent: ctx.watcher.spec.intent,
+                    },
+                },
+            });
+            return;
+        }
+        // SPEC-27 (ADR-011): stateful agent cycle 호출 (fire-and-forget)
+        const startedAt = Date.now();
+        executePersonaCycle(ctx.watcher.personaSlug, {
+            kind: "watcher",
+            watcherId: ctx.watcher.id,
+            intent: ctx.watcher.spec.intent,
+        }).then((result) => {
+            const elapsedMs = Date.now() - startedAt;
+            if (!result.ok) {
+                console.warn(`[executor] trigger 재호출 실패 · ${ctx.watcher.personaSlug} · ${result.stage} · ${result.error}`);
+                // 실패도 반드시 journal 기록 (사후 자율 사이클 진단 · 사용자 추적 가능)
+                logDecision({
+                    personaSlug: ctx.watcher.personaSlug,
+                    llmContext: {
+                        followup_status: "failed",
+                        stage: result.stage,
+                        error: result.error,
+                        triggered_by: {
+                            watcherId: ctx.watcher.id,
+                            intent: ctx.watcher.spec.intent,
+                        },
+                        elapsedMs,
+                    },
+                });
+            }
+            else {
+                const stateAfter = result.stateAfter;
+                console.log(`[agent] trigger cycle 완료 · ${ctx.watcher.personaSlug} · ${result.elapsedMs}ms · ` +
+                    `watchlist ${stateAfter?.watchlist.length ?? 0} · positions ${stateAfter?.positions.length ?? 0} · ` +
+                    `nextRunAt ${stateAfter?.nextRunAt ?? "(없음)"}`);
+            }
+        }).catch((e) => {
+            const elapsedMs = Date.now() - startedAt;
+            console.error(`[executor] trigger 재호출 예외 · ${ctx.watcher.personaSlug}:`, e);
+            // 예외도 journal 기록 (try/catch 누락 회귀 시 사후 진단)
+            logDecision({
+                personaSlug: ctx.watcher.personaSlug,
+                llmContext: {
+                    followup_status: "exception",
+                    stage: "trigger_callback",
+                    error: String(e),
+                    triggered_by: {
+                        watcherId: ctx.watcher.id,
+                        intent: ctx.watcher.spec.intent,
+                    },
+                    elapsedMs,
+                },
+            });
+        });
+    });
+    // ── 서버 구독 동기화 시작 (1시간 주기 + 즉시 1회) ─────────
+    startPeriodicSync(3600_000);
+    // ── 페르소나 일기 cron 폐기 (SPEC-27 ADR-012) ─────────
+    //   AI 가 strategy.md 안에서 직접 일기 형식으로 갱신함.
+    // ── SQLite watchers 테이블 vacuum (P1-4) — 30일+ 된 non-active row 자동 정리 ──
+    // 1년+ 운영 시 누적으로 restoreFromDb 성능 ↓ 방지. status='active' row 는 절대 건드리지 않음.
+    try {
+        const { vacuumWatchersOlderThan } = await import("./db/sqlite.js");
+        const removed = vacuumWatchersOlderThan(30);
+        if (removed > 0)
+            console.log(`[startup] watchers vacuum · removed ${removed} old rows (>30d non-active)`);
+    }
+    catch (e) {
+        console.warn("[startup] watchers vacuum 실패:", e);
+    }
+    // ── Watcher SQLite 복원 (SPEC-11) — restart 시 active watcher 재무장 ──
+    await getConditionWatcher().restoreFromDb();
+    // ── Universe sync cron 폐기 (SPEC-27 ADR-012) ──
+    //   AI 가 필요할 때 도구로 호출 (또는 사용자가 수동 트리거)
+    // ── System watchdog (SPEC-27 ADR-012) — 1분 polling
+    //    nextRunAt 도달 시 cycle 발화 + 잠듦 감지 alert
+    //    이건 "AI 행동 cron" 이 아닌 자율 시스템의 인프라 안전망
+    startWatchdog();
+    // ── 정적 파일 (Vite 빌드 결과) ─────────────────────────────
+    const webDist = path.resolve(__dirname, "../web");
+    if (fs.existsSync(webDist)) {
+        await app.register(fastifyStatic, {
+            root: webDist,
+            prefix: "/",
+            index: ["index.html"],
+        });
+        // SPA fallback (Fastify 는 자동 fallback 없음 · setNotFoundHandler 로 index 반환)
+        app.setNotFoundHandler((req, reply) => {
+            if (req.url.startsWith("/api")) {
+                reply.code(404).send({ error: "API route not found" });
+                return;
+            }
+            reply.type("text/html").send(fs.readFileSync(path.join(webDist, "index.html")));
+        });
+    }
+    else {
+        console.warn(`[client] 빌드된 web 없음: ${webDist}\n` +
+            `  - 개발: 이 Fastify 는 API 전용으로 돌고 UI 는 'npm run dev:web' 의 Vite dev server (http://localhost:5173) 에서.\n` +
+            `  - 배포: 'npm run build' 후 dist/web 생성되면 이 서버가 함께 서빙.`);
+    }
+    // ── Graceful shutdown (SIGINT / SIGTERM · SPEC-25 line 743-744 보강) ──
+    //
+    // 순서:
+    //   1. Fastify close (새 요청 accept 중지 + 진행 중 요청 완료 대기)
+    //   2. ConditionWatcher.pauseTimers() (timer 만 정리 · DB watchers row 보존 → restart 시 복원)
+    //   3. OrderTracker.pauseAllPolling() (polling timer 정리 · 주문 상태는 키움 측에서 진행)
+    //   4. PriceFeed.stop()
+    //   5. cron 정리 (server-sync · diary · universe-sync)
+    //   6. closeDb (마지막)
+    //   7. process.exit(0)
+    //
+    // Ctrl+C 직후 즉시 종료 시 위험:
+    //   - 진행 중 키움 API 호출 끊김 (응답 손실)
+    //   - 진행 중 주문 polling 중단 (체결 정보 누락)
+    //   - DB write 중간 끊김 가능
+    let shuttingDown = false;
+    const shutdown = async (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.log(`\n[shutdown] ${signal} received · graceful close 시작...`);
+        try {
+            await app.close();
+            console.log("[shutdown] Fastify closed");
+        }
+        catch (e) {
+            console.error("[shutdown] Fastify close err:", e);
+        }
+        try {
+            getConditionWatcher().pauseTimers();
+            getOrderTracker().pauseAllPolling();
+            getPriceFeed().stop();
+            stopPeriodicSync();
+            stopWatchdog();
+        }
+        catch (e) {
+            console.error("[shutdown] cleanup err:", e);
+        }
+        try {
+            const { closeDb } = await import("./db/sqlite.js");
+            closeDb();
+            console.log("[shutdown] SQLite closed");
+        }
+        catch (e) {
+            console.error("[shutdown] closeDb err:", e);
+        }
+        console.log("[shutdown] complete");
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    try {
+        await app.listen({ port, host: HOST });
+        const url = `http://${HOST}:${port}`;
+        console.log(`\n🚀 mulsok-traders client · ${url}\n`);
+        // 개발 모드 (web 빌드 없음) 에는 Vite dev 사이트를 열어주는 편이 UX 가 좋음
+        const isDev = !fs.existsSync(webDist);
+        const openTarget = isDev ? "http://localhost:5173" : url;
+        // 기본 안 열림 · 명시적으로 OPEN=1 일 때만 자동 오픈 (개발 중 빈번한 재시작 방해 방지)
+        if (process.env.OPEN === "1") {
+            try {
+                await open(openTarget);
+            }
+            catch (e) {
+                console.warn(`[client] 브라우저 자동 오픈 실패 · 수동으로 ${openTarget} 열어주세요. (${e})`);
+            }
+        }
+        else {
+            console.log(`[client] 브라우저 자동 오픈 비활성 (수동: ${openTarget} · 자동 원하면 OPEN=1)`);
+        }
+    }
+    catch (e) {
+        console.error("[client] listen 실패:", e);
+        process.exit(1);
+    }
+}
+main().catch((e) => {
+    console.error("[client] bootstrap 실패:", e);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src-server/index.ts"],"names":[],"mappings":"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"}

package/dist/server/jobs/universe-sync.js

@@ -0,0 +1,132 @@
+/**
+ * 유니버스 + 일봉 배치 job (apps/client)
+ *
+ * 흐름:
+ *   1. ka10099 → KOSPI + KOSDAQ 전종목 → SQLite universe 테이블
+ *   2. 각 종목 ka10081 일봉 120일 → SQLite daily_candles 테이블
+ *   3. sync_meta 에 결과 기록
+ *
+ * 호출 시점:
+ *   - 장 마감 후 수동 호출 (/api/jobs/universe-sync POST)
+ *   - 혹은 daily cron (추후 스케줄러 추가 시)
+ *
+ * 소요:
+ *   - 유니버스 2호출 (KOSPI + KOSDAQ) · ~3000건
+ *   - 일봉 ~3000 * 1호출 = ~3000 req · live 5/s → 10분
+ *   - 초기 실행은 분할 권장 (opts.maxCodes 로 제한)
+ *
+ * Rate limit 안전:
+ *   - kiwoom-client 의 rate limiter 가 자동으로 stagger
+ *   - 배치 루프는 단순 순차 await · 별도 sleep 불필요
+ */
+import { getDailyChart, getStandardUniverse } from "../broker/kiwoom/index.js";
+import { upsertUniverseBulk, upsertCandlesBulk, recordSync, } from "../db/sqlite.js";
+/**
+ * 유니버스 + 일봉 배치 전체 실행.
+ */
+export async function runUniverseSync(opts = {}) {
+    const start = Date.now();
+    const maxCodes = opts.maxCodes ?? 50;
+    const candleDays = opts.candleDays ?? 120;
+    /* ─── 1. 유니버스 ─── */
+    const uniRes = await getStandardUniverse();
+    if (!uniRes.ok) {
+        recordSync("universe", 0, "error", uniRes.error.message);
+        return { universeCount: 0, candlesCount: 0, errorCount: 1, elapsedMs: Date.now() - start };
+    }
+    const allItems = [
+        ...uniRes.data.kospi.map((item) => ({ item, market: "kospi" })),
+        ...uniRes.data.kosdaq.map((item) => ({ item, market: "kosdaq" })),
+    ];
+    const universeRows = allItems.map(({ item, market }) => ({
+        code: item.code,
+        name: item.name,
+        market,
+        market_code: item.marketCode,
+        up_name: item.upName,
+        up_size_name: item.upSizeName,
+        list_count: item.listCount,
+        last_price_krw: item.lastPriceKrw,
+        reg_day: item.regDay,
+        state: item.state,
+        audit_info: item.auditInfo,
+        order_warning_code: item.orderWarningCode,
+        company_class_name: item.companyClassName,
+        nxt_enable: item.nxtEnable ? 1 : 0,
+        updated_at: new Date().toISOString(),
+    }));
+    upsertUniverseBulk(universeRows);
+    recordSync("universe", universeRows.length);
+    /* ─── 2. 일봉 (타겟 코드 우선 · 없으면 maxCodes 제한) ─── */
+    let target;
+    if (opts.targetCodes && opts.targetCodes.length > 0) {
+        const wanted = new Set(opts.targetCodes.map((c) => c.replace(/^A/, "")));
+        target = universeRows.filter((r) => wanted.has(r.code));
+    }
+    else {
+        target = maxCodes > 0 ? universeRows.slice(0, maxCodes) : universeRows;
+    }
+    let candlesCount = 0;
+    let errorCount = 0;
+    for (let i = 0; i < target.length; i++) {
+        const row = target[i];
+        const chartRes = await getDailyChart(row.code, candleDays);
+        opts.onProgress?.(i + 1, target.length, row.code);
+        if (!chartRes.ok) {
+            errorCount++;
+            continue;
+        }
+        const candleRows = chartRes.data.candles.map((c) => ({
+            code: row.code,
+            date: c.date,
+            open_krw: Math.round(c.openKrw),
+            high_krw: Math.round(c.highKrw),
+            low_krw: Math.round(c.lowKrw),
+            close_krw: Math.round(c.closeKrw),
+            volume: Math.round(c.volume),
+        }));
+        upsertCandlesBulk(candleRows);
+        candlesCount += candleRows.length;
+    }
+    recordSync(`candles:${new Date().toISOString().slice(0, 10)}`, candlesCount, errorCount === 0 ? "ok" : "error", errorCount > 0 ? `${errorCount}건 실패` : undefined);
+    return {
+        universeCount: universeRows.length,
+        candlesCount,
+        errorCount,
+        elapsedMs: Date.now() - start,
+    };
+}
+/* ─────────── 자동 cron (SPEC-19 · 매일 16:30 KST 캔들 backfill) ─────────── */
+let cronTimer = null;
+/**
+ * 매 분 시각 체크 → 16:30 KST 도달 시 자동 sync.
+ * 평일만 (주말 KRX 휴장).
+ */
+export function startUniverseSyncCron() {
+    if (cronTimer)
+        return;
+    cronTimer = setInterval(async () => {
+        const now = new Date();
+        const kst = new Date(now.getTime() + 9 * 3600_000);
+        const day = kst.getUTCDay();
+        if (day === 0 || day === 6)
+            return; // 주말 skip
+        if (kst.getUTCHours() === 16 && kst.getUTCMinutes() === 30) {
+            console.log("[universe-sync cron] 16:30 KST · 자동 backfill 시작");
+            try {
+                const r = await runUniverseSync({});
+                console.log(`[universe-sync cron] 완료 · universe ${r.universeCount} · candles ${r.candlesCount} · err ${r.errorCount} · ${r.elapsedMs}ms`);
+            }
+            catch (e) {
+                console.error("[universe-sync cron] 실패:", e);
+            }
+        }
+    }, 60_000);
+    console.log("[universe-sync] cron started · 매일 16:30 KST 자동 backfill");
+}
+export function stopUniverseSyncCron() {
+    if (cronTimer)
+        clearInterval(cronTimer);
+    cronTimer = null;
+}
+//# sourceMappingURL=universe-sync.js.map

package/dist/server/jobs/universe-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universe-sync.js","sourceRoot":"","sources":["../../../src-server/jobs/universe-sync.ts"],"names":[],"mappings":"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"}

package/dist/server/jobs/watchdog.js

@@ -0,0 +1,87 @@
+/**
+ * SPEC-27 · System Watchdog (ADR-012).
+ *
+ * 페르소나 자율 발화의 안전망. 1분마다 polling:
+ *   1. 모든 구독 페르소나의 state.json 의 nextRunAt 확인
+ *      - 도달 → executePersonaCycle({ kind: "scheduled" })
+ *   2. 페르소나 잠듦 감지
+ *      - lastRunAt 24시간 + nextRunAt 없음 + 활성 watcher 0
+ *        → console.warn + journal warn 이벤트 (UI banner 노출)
+ *
+ * AI 의 행동을 발화시키는 cron 이 아님 — 자율 시스템의 인프라 안전망.
+ */
+import { loadConfig } from "../config.js";
+import { loadState } from "../personas/persona-state.js";
+import { executePersonaCycle } from "../personas/persona-agent.js";
+import { getConditionWatcher } from "../watchers/condition-watcher.js";
+const POLL_INTERVAL_MS = 60_000; // 1분
+const ASLEEP_THRESHOLD_MS = 24 * 3600_000; // 24시간
+let timer = null;
+const lastFiredAt = {}; // slug → ISO (중복 방지)
+const lastAlertedAt = {}; // slug → ISO (alert 중복 방지 · 6시간)
+export function startWatchdog() {
+    if (timer)
+        return;
+    timer = setInterval(() => { void tick(); }, POLL_INTERVAL_MS);
+    // 첫 부팅 시 즉시 1회 (지각된 nextRunAt 처리)
+    void tick();
+    console.log("[watchdog] started · 1분 polling · nextRunAt + 잠듦 감지");
+}
+export function stopWatchdog() {
+    if (timer)
+        clearInterval(timer);
+    timer = null;
+}
+async function tick() {
+    const cfg = loadConfig();
+    if (cfg.halted)
+        return; // halted 시 아무것도 안 함 (SPEC-26)
+    const subs = cfg.subscriptions ?? [];
+    for (const slug of subs) {
+        try {
+            await checkPersona(slug);
+        }
+        catch (e) {
+            console.warn(`[watchdog] ${slug} tick 실패:`, e);
+        }
+    }
+}
+async function checkPersona(slug) {
+    const state = loadState(slug);
+    const now = Date.now();
+    // 1. nextRunAt 도달 → cycle 발화
+    if (state.nextRunAt) {
+        const nextMs = new Date(state.nextRunAt).getTime();
+        if (!Number.isNaN(nextMs) && nextMs <= now) {
+            const fireKey = state.nextRunAt;
+            if (lastFiredAt[slug] !== fireKey) {
+                lastFiredAt[slug] = fireKey;
+                console.log(`[watchdog] ${slug} nextRunAt 도달 (${state.nextRunAt}) · cycle 발화`);
+                const r = await executePersonaCycle(slug, { kind: "scheduled" });
+                console.log(`[watchdog] ${slug} cycle ${r.ok ? "✓" : `✗ ${r.stage}`} · ${r.elapsedMs}ms`);
+                return; // 이번 tick 종료 (cycle 후 state 갱신됨)
+            }
+        }
+    }
+    // 2. 잠듦 감지
+    const lastMs = new Date(state.lastRunAt).getTime();
+    if (Number.isNaN(lastMs))
+        return;
+    const sinceLast = now - lastMs;
+    if (sinceLast < ASLEEP_THRESHOLD_MS)
+        return;
+    if (state.nextRunAt)
+        return; // 다음 깨우기 잡혀있음
+    // 활성 watcher 가 있으면 잠든 게 아님 (시세 발화 대기 중)
+    const activeWatchers = getConditionWatcher().list({ personaSlug: slug, activeOnly: true }).length;
+    if (activeWatchers > 0)
+        return;
+    // 진짜 잠듦 — alert (6시간 1회 dedupe)
+    const alertKey = new Date(now).toISOString().slice(0, 13); // 시간 단위
+    if (lastAlertedAt[slug] === alertKey)
+        return;
+    lastAlertedAt[slug] = alertKey;
+    console.warn(`[watchdog] ⚠ ${slug} 잠들음 · lastRunAt ${state.lastRunAt} (${Math.floor(sinceLast / 3600_000)}h 전) · ` +
+        `nextRunAt 없음 · 활성 watcher 0`);
+}
+//# sourceMappingURL=watchdog.js.map

package/dist/server/jobs/watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog.js","sourceRoot":"","sources":["../../../src-server/jobs/watchdog.ts"],"names":[],"mappings":"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"}