@mulsok/traders-client 0.1.0

package/dist/server/llm/openai.js

@@ -0,0 +1,87 @@
+/** OpenAI finish_reason → 표준 LlmStopReason 매핑 */
+function mapOpenAIStopReason(raw) {
+    switch (raw) {
+        case "stop": return "stop";
+        case "length": return "max_tokens";
+        case "tool_calls": return "tool_use";
+        case "function_call": return "tool_use";
+        case "content_filter": return "safety";
+        default: return "unknown";
+    }
+}
+const BASE = "https://api.openai.com/v1";
+/**
+ * OpenAI 기본 max_tokens — 응답 잘림 방지 (사용자 정정 · 2026-05-03).
+ * gpt-4o · gpt-4o-mini 의 model 한계 (16384) 까지 자유 출력 허용.
+ * fetch timeout 없음 (무한대 대기).
+ */
+const DEFAULT_MAX_TOKENS = 16384;
+export function createOpenAIProvider(opts) {
+    return {
+        kind: "openai",
+        async test() {
+            if (!opts.apiKey)
+                return { ok: false, provider: "openai", error: "apiKey 없음" };
+            try {
+                const res = await fetch(`${BASE}/models`, {
+                    headers: { authorization: `Bearer ${opts.apiKey}` },
+                });
+                if (!res.ok) {
+                    return {
+                        ok: false,
+                        provider: "openai",
+                        error: `HTTP ${res.status}: ${(await res.text()).slice(0, 120)}`,
+                    };
+                }
+                const data = (await res.json());
+                const has = data.data?.some((m) => m.id === opts.model);
+                return {
+                    ok: !!has,
+                    provider: "openai",
+                    model: opts.model,
+                    detail: has ? "model 확인됨" : "model 목록에 없음",
+                };
+            }
+            catch (e) {
+                return { ok: false, provider: "openai", error: String(e) };
+            }
+        },
+        async complete(c) {
+            if (!opts.apiKey)
+                throw new Error("OpenAI apiKey 없음");
+            const res = await fetch(`${BASE}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    authorization: `Bearer ${opts.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: opts.model,
+                    messages: [
+                        ...(c.systemPrompt ? [{ role: "system", content: c.systemPrompt }] : []),
+                        { role: "user", content: c.userPrompt },
+                    ],
+                    max_tokens: c.maxTokens ?? DEFAULT_MAX_TOKENS,
+                    temperature: c.temperature ?? 0.2,
+                }),
+            });
+            if (!res.ok)
+                throw new Error(`OpenAI HTTP ${res.status}: ${await res.text()}`);
+            const data = (await res.json());
+            return {
+                text: data.choices?.[0]?.message?.content ?? "",
+                model: opts.model,
+                provider: "openai",
+                stopReason: mapOpenAIStopReason(data.choices?.[0]?.finish_reason),
+                usage: data.usage
+                    ? {
+                        inputTokens: data.usage.prompt_tokens ?? 0,
+                        outputTokens: data.usage.completion_tokens ?? 0,
+                    }
+                    : undefined,
+                raw: data,
+            };
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/server/llm/openai.js.map

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

package/dist/server/personas/executor.js

@@ -0,0 +1,318 @@
+/**
+ * Persona executor · 페르소나 단일 실행 사이클
+ *
+ * 흐름 (SPEC-10):
+ *   1. checkLlmCallSafety (emergency stop)
+ *   2. runPersonaScreening (frontmatter 기반)
+ *   3. Bundle (common + persona) + Layer 3 header + patches 조립
+ *   4. LLM 호출
+ *   5. logDecision (journal 기록)
+ *   6. extractAction → action="buy"/"sell" 시 safety 체크 + placeOrderWithTracking 호출
+ *   7. extractWakePlan → ConditionWatcher 자동 등록
+ *   8. 결과 반환
+ *
+ * 사용처:
+ *   - HTTP API (/api/screen/:persona/decide) · routes.ts 에서 호출
+ *   - ConditionWatcher 트리거 콜백 · index.ts 에서 호출
+ *
+ * 자율성 원칙 (SPEC-10): rate limit 폐기 (키움 broker rate limit 만 유효).
+ */
+import { fetchCommonBundle, fetchPersonaBundle, assembleFullPrompt } from "../bundle.js";
+import { loadConfig, SERVER_BASE_URL } from "../config.js";
+import { createLlmProvider } from "../llm/index.js";
+import { collectLayer3Snapshot, formatLayer3Markdown, loadActivePatches } from "../llm/context-builder.js";
+import { logDecision, logOrderRejected } from "../journal/trade-journal.js";
+import { buildPersonaCandidatesContext, runPersonaScreening } from "./runner.js";
+import { extractWakePlan, registerWakePlan } from "./wake-plan.js";
+import { placeOrderWithTracking } from "../broker/kiwoom/index.js";
+import { checkLlmCallSafety, checkOrderSafety } from "../safety.js";
+export function extractDecidedAction(rawText) {
+    if (!rawText)
+        return null;
+    try {
+        const m = rawText.match(/```(?:json)?\s*([\s\S]*?)```/);
+        const t = m ? m[1] : rawText;
+        const obj = JSON.parse(t);
+        const action = obj.action;
+        if (!["buy", "sell", "skip", "hold"].includes(action))
+            return null;
+        return {
+            action,
+            symbolCode: typeof obj.symbol_code === "string" ? obj.symbol_code : undefined,
+            symbolName: typeof obj.symbol_name === "string" ? obj.symbol_name : undefined,
+            quantity: typeof obj.quantity === "number" ? obj.quantity : undefined,
+            targetPriceKrw: typeof obj.target_price_krw === "number" ? obj.target_price_krw : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/* ─────────── 메인 실행기 ─────────── */
+//
+// 자율성 원칙 (사용자 정정 · 2026-05-02 · SPEC-10):
+//   - executor 는 LLM 호출 횟수·간격에 어떤 제약도 강제하지 않음
+//   - 유일한 rate limit = 키움 REST API (broker 레이어 · SPEC-13 TokenBucket)
+//   - 무한 루프 방어는 wake-plan zod schema (SPEC-4) 의 minimum interval 로 처리
+export async function executePersonaDecision(personaSlug, opts = {}) {
+    const triggeredBy = opts.triggeredBy;
+    // Emergency Stop 체크 (SPEC-26)
+    const llmGuard = checkLlmCallSafety();
+    if (!llmGuard.ok) {
+        return { ok: false, stage: "llm", error: `safety:${llmGuard.code} · ${llmGuard.reason}`, triggeredBy };
+    }
+    // LLM provider
+    const cfg = loadConfig();
+    const prov = createLlmProvider(cfg);
+    if (!prov) {
+        return { ok: false, stage: "llm", error: "LLM provider 미설정", triggeredBy };
+    }
+    // 스크리닝
+    const screening = await runPersonaScreening(personaSlug);
+    if (!screening) {
+        return { ok: false, stage: "persona", error: `persona '${personaSlug}' 미존재`, triggeredBy };
+    }
+    if (screening.skipped) {
+        return {
+            ok: false,
+            stage: "persona",
+            error: `persona screener skipped · ${screening.skipReason ?? ""}`,
+            persona: screening.persona,
+            triggeredBy,
+        };
+    }
+    // Bundle 조립
+    // 페르소나 = server (Supabase) 단일 진실 소스 (ADR-009).
+    // local yaml 만 있는 페르소나는 정식 페르소나가 아니므로 server bundle fetch 실패 시 그대로 에러.
+    // Layer3 snapshot 은 prompt 와 journal 양쪽에 사용 (외부 API 1회만).
+    let systemPrompt;
+    let layer3Snapshot = null;
+    try {
+        const common = await fetchCommonBundle(SERVER_BASE_URL);
+        const personaB = await fetchPersonaBundle(SERVER_BASE_URL, personaSlug, cfg.auth?.deviceToken);
+        const layer2Body = personaB.bundle.body;
+        layer3Snapshot = await collectLayer3Snapshot({ personaSlug });
+        const baseLayer3 = formatLayer3Markdown(layer3Snapshot);
+        const candidatesSection = buildPersonaCandidatesContext(screening, opts.topN ?? 8);
+        const layer3 = triggeredBy
+            ? `${baseLayer3}\n\n## 트리거 이벤트\n\n이번 실행은 감시자 트리거에 의해 발생했습니다.\n- Watcher ID: \`${triggeredBy.watcherId}\`\n- Intent: ${triggeredBy.intent}\n\n${candidatesSection}`
+            : `${baseLayer3}\n\n${candidatesSection}`;
+        const layer3Patches = loadActivePatches(personaSlug);
+        systemPrompt = assembleFullPrompt({
+            layer1: common.bundle.body,
+            layer2: layer2Body,
+            layer3Header: layer3,
+            layer3Patches: layer3Patches || undefined,
+        });
+    }
+    catch (e) {
+        return { ok: false, stage: "llm", error: `bundle 조립 실패: ${String(e)}`, persona: screening.persona, triggeredBy };
+    }
+    // LLM 호출
+    // - maxTokens 명시 X → provider 의 모델별 default 사용 (Anthropic 8192 / OpenAI 16384 / Gemini 8192)
+    // - 사용자 정정 (2026-05-03): timeout/maxTokens 제한 → 답변 잘림 → 재호출 비용 더 큼 → 없어야 한다.
+    // - 잘림 (max_tokens) 감지 시 journal 에 truncated:true + 경고 로그 (사후 추적).
+    let llmRes;
+    try {
+        llmRes = await prov.complete({
+            systemPrompt,
+            userPrompt: triggeredBy
+                ? `감시자 트리거로 재호출되었습니다 (${triggeredBy.intent}). 현재 상황을 종합해 오늘 거래 의사결정을 하나의 JSON 으로 응답하세요. action / symbol_code (있을 때) / reasoning / wake_plan / neoul 객체 포함.`
+                : "위 스크리닝 결과를 종합해서 오늘 거래 의사결정을 하나의 JSON 으로 응답하세요. action / symbol_code (있을 때) / reasoning / wake_plan / neoul 객체 포함.",
+        });
+    }
+    catch (e) {
+        return { ok: false, stage: "llm", error: `LLM 호출 실패: ${String(e)}`, persona: screening.persona, triggeredBy };
+    }
+    // 잘림 감지 — max_tokens / safety / unknown 일 때 경고
+    const truncated = llmRes.stopReason === "max_tokens";
+    if (truncated) {
+        console.warn(`[executor] ⚠️  ${personaSlug} LLM 응답이 max_tokens cap 에 막혀 잘림 (model=${llmRes.model} · output=${llmRes.usage?.outputTokens ?? "?"} tokens)`);
+    }
+    else if (llmRes.stopReason === "safety") {
+        console.warn(`[executor] ⚠️  ${personaSlug} LLM safety filter 차단 (model=${llmRes.model})`);
+    }
+    // Journal 기록 (전략 리뷰 풍부 컨텍스트 · SPEC-9 line 54-62)
+    // - reasoning 전체 보존 (truncate 제거 · 긴 추론도 사후 분석 가능)
+    // - top 8 후보 마다 rawMetrics + matchedPatterns + humanSummary + reasons (정량 + 자연어 동시)
+    // - diagnostics (rejectedBy + patternReject) — "후보 적은 이유" 기록
+    // - layer3_snapshot — LLM 호출 시점의 시장·보유·미체결·watcher 상태 재현용
+    // - stop_reason + truncated — 잘림 감지 (사후 비정상 case 추적)
+    logDecision({
+        personaSlug,
+        llmContext: {
+            reasoning: llmRes.text,
+            model: llmRes.model,
+            tokens: llmRes.usage,
+            stopReason: llmRes.stopReason,
+            truncated,
+            triggered_by: triggeredBy ?? null,
+            screening_summary: {
+                universe: screening.screener.universeSize,
+                evaluated: screening.screener.evaluated,
+                candidates: screening.screener.candidates.length,
+                skippedNoCandles: screening.screener.skippedNoCandles,
+                elapsedMs: screening.screener.elapsedMs,
+                diagnostics: {
+                    rejectedBy: screening.screener.diagnostics.rejectedBy,
+                    patternReject: screening.screener.diagnostics.patternReject,
+                    samples: screening.screener.diagnostics.samples,
+                },
+                top: screening.screener.candidates.slice(0, 8).map((c) => ({
+                    code: c.code,
+                    name: c.name,
+                    score: c.score,
+                    matchedPatterns: c.matchedPatterns,
+                    rawMetrics: c.rawMetrics,
+                    humanSummary: c.humanSummaries.join(" / "),
+                    reasons: c.reasons,
+                    ma: c.ma,
+                    todayChangePct: c.todayChangePct,
+                    lastPriceKrw: c.lastPriceKrw,
+                })),
+            },
+            layer3_snapshot: layer3Snapshot,
+        },
+    });
+    // 주문 실행 (action="buy"/"sell" 시) — SPEC-10 + SPEC-26 safety 게이트
+    let orderMeta;
+    const decided = extractDecidedAction(llmRes.text);
+    if (decided && (decided.action === "buy" || decided.action === "sell")) {
+        if (!decided.symbolCode || !decided.quantity) {
+            orderMeta = { sent: false, reason: `LLM action=${decided.action} 인데 symbol_code 또는 quantity 누락` };
+            console.warn(`[executor] ${personaSlug} 주문 skip · ${orderMeta.reason}`);
+        }
+        else {
+            const safety = await checkOrderSafety({
+                personaSlug,
+                symbolCode: decided.symbolCode,
+                side: decided.action,
+                quantity: decided.quantity,
+                priceKrw: decided.targetPriceKrw,
+            });
+            if (!safety.ok) {
+                orderMeta = { sent: false, reason: `safety:${safety.code} · ${safety.reason}` };
+                console.warn(`[executor] ${personaSlug} 주문 차단 · ${orderMeta.reason}`);
+                logOrderRejected({
+                    personaSlug,
+                    symbolCode: decided.symbolCode,
+                    side: decided.action,
+                    quantity: decided.quantity,
+                    priceKrw: decided.targetPriceKrw ?? 0,
+                    clientOrderId: `safety_${Date.now()}`,
+                    error: `safety:${safety.code} · ${safety.reason}`,
+                });
+            }
+            else {
+                try {
+                    const placed = await placeOrderWithTracking({
+                        symbolCode: decided.symbolCode,
+                        side: decided.action,
+                        quantity: decided.quantity,
+                        priceKrw: decided.targetPriceKrw,
+                        type: decided.targetPriceKrw ? "limit" : "market",
+                    }, { personaSlug });
+                    if (placed.ok) {
+                        orderMeta = {
+                            sent: true,
+                            clientOrderId: placed.data.clientOrderId,
+                            brokerOrderNo: placed.data.brokerOrderNo,
+                            status: placed.data.status,
+                        };
+                        console.log(`[executor] ${personaSlug} 주문 접수 · ${decided.action} ${decided.symbolCode} ${decided.quantity}주 · ${placed.data.clientOrderId}`);
+                    }
+                    else {
+                        orderMeta = { sent: false, reason: `broker reject · ${placed.error.message}` };
+                        console.warn(`[executor] ${personaSlug} broker reject · ${placed.error.message}`);
+                    }
+                }
+                catch (e) {
+                    orderMeta = { sent: false, reason: `exception · ${String(e)}` };
+                    console.error(`[executor] ${personaSlug} 주문 예외:`, e);
+                }
+            }
+        }
+    }
+    else if (decided) {
+        // skip / hold — 기록만
+        orderMeta = { sent: false, reason: `LLM action=${decided.action}` };
+    }
+    else {
+        orderMeta = { sent: false, reason: "LLM 응답에서 action 파싱 실패" };
+    }
+    // wake_plan 파싱 + 자동 등록
+    let wakePlanMeta;
+    const extracted = extractWakePlan(llmRes.text);
+    if (!extracted.ok) {
+        wakePlanMeta = {
+            parsed: null,
+            registered: 0,
+            skipped: [],
+            nextScheduledRegistered: false,
+            parseError: extracted.error,
+        };
+        console.warn(`[executor] ${personaSlug} wake_plan 파싱 실패: ${extracted.error}`);
+    }
+    else if (extracted.wakePlan) {
+        const reg = registerWakePlan(personaSlug, extracted.wakePlan);
+        wakePlanMeta = {
+            parsed: extracted.wakePlan,
+            registered: reg.registered.length,
+            skipped: reg.skipped,
+            nextScheduledRegistered: reg.nextScheduledRegistered,
+        };
+        console.log(`[executor] ${personaSlug} wake_plan 등록 · time/price/event ${reg.registered.length} · skipped ${reg.skipped.length} · next_scheduled ${reg.nextScheduledRegistered ? "✓" : "-"}`);
+    }
+    // SPEC §6.1 + Layer 1 c1.8.0 §wake_plan 가드:
+    //   wake_plan 누락 + tool call 로도 active watcher 등록 X 면 페르소나가 잠들 위험.
+    //   여기서는 비용 폭주 방지를 위해 자동 재호출은 하지 않고 강한 경고만 남긴다.
+    //   사용자/UI 가 cycle 결과의 wakePlan.silentDrift = true 를 보고 조치.
+    try {
+        const { getConditionWatcher } = await import("../watchers/condition-watcher.js");
+        const activeAfter = getConditionWatcher().list({ personaSlug, activeOnly: true }).length;
+        if ((!wakePlanMeta || wakePlanMeta.registered === 0) && activeAfter === 0) {
+            console.error(`[executor] ⚠ ${personaSlug} wake_plan 미등록 + active watcher 0 — 페르소나 잠듦 위험. ` +
+                `Layer 1 c1.8.0 §wake_plan 매 응답 필수.`);
+            wakePlanMeta = {
+                parsed: wakePlanMeta?.parsed ?? null,
+                registered: wakePlanMeta?.registered ?? 0,
+                skipped: wakePlanMeta?.skipped ?? [],
+                nextScheduledRegistered: wakePlanMeta?.nextScheduledRegistered ?? false,
+                parseError: wakePlanMeta?.parseError,
+                silentDrift: true,
+            };
+        }
+    }
+    catch {
+        // 가드 실패는 cycle 자체를 막지 않음.
+    }
+    return {
+        ok: true,
+        persona: screening.persona,
+        screening: {
+            universe: screening.screener.universeSize,
+            evaluated: screening.screener.evaluated,
+            candidates: screening.screener.candidates.length,
+            topCandidates: screening.screener.candidates.slice(0, opts.topN ?? 8),
+        },
+        llm: {
+            model: llmRes.model,
+            tokens: llmRes.usage,
+            response: llmRes.text,
+            assembled_length: systemPrompt.length,
+        },
+        wakePlan: wakePlanMeta,
+        order: orderMeta,
+        triggeredBy,
+    };
+}
+/* ─────────── 진단 ─────────── */
+//
+// 진단 메타는 trade-journal 의 readEvents() 에서 구할 수 있음.
+// 별도 module-level Map 추적은 폐기 (SPEC-10 정정 · rate limit 폐기와 함께).
+//
+// e.g. 페르소나의 마지막 실행 시각 / 시간당 호출 수 조회:
+//   const events = readEvents({ eventTypes: ["decision"], personaSlug, from: oneHourAgo });
+//   const lastRunAt = events.at(-1)?.timestamp;
+//   const recentHourCount = events.length;
+//# sourceMappingURL=executor.js.map

package/dist/server/personas/executor.js.map

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

package/dist/server/personas/loader.js

@@ -0,0 +1,165 @@
+/**
+ * 페르소나 로더 · parser
+ *
+ * 입력 소스 (우선순위):
+ *   1. 서버 Bundle API 의 persona body (Supabase · 실 배포)
+ *      └ body markdown 상단의 `---` frontmatter 를 추출
+ *   2. 로컬 override 파일 `~/.mulsok-traders/personas/<slug>.yaml`
+ *      └ Supabase 배포 전 개발용 · frontmatter 만 저장 (본문 없음)
+ *
+ * 출력:
+ *   PersonaDef = { slug, frontmatter, promptBody, source }
+ *
+ * 캐시:
+ *   60초 (빈번한 스크리닝 호출 고려 · Supabase 부담 경감)
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import matter from "gray-matter";
+import { fetchPersonaBundle } from "../bundle.js";
+import { SERVER_BASE_URL, loadConfig } from "../config.js";
+import { PersonaFrontmatterSchema, } from "./schema.js";
+const CACHE = new Map();
+const CACHE_TTL_MS = 60_000;
+const OVERRIDE_DIR = path.join(os.homedir(), ".mulsok-traders", "personas");
+/**
+ * 페르소나 slug 로 정의 확보.
+ *
+ * @param slug 페르소나 슬러그 (예: "neoul")
+ * @returns PersonaDef · Supabase 가 있으면 그 frontmatter + 본문 · 없으면 로컬 override · 둘 다 없으면 null
+ */
+export async function loadPersona(slug) {
+    const now = Date.now();
+    const cached = CACHE.get(slug);
+    if (cached && cached.expiresAt > now)
+        return cached.def;
+    const def = await loadPersonaFresh(slug);
+    if (def)
+        CACHE.set(slug, { def, expiresAt: now + CACHE_TTL_MS });
+    return def;
+}
+/** 캐시 무시 · 강제 재로드 */
+export async function reloadPersona(slug) {
+    CACHE.delete(slug);
+    return loadPersona(slug);
+}
+async function loadPersonaFresh(slug) {
+    let supabaseFm = null;
+    let supabaseBody = "";
+    let rawBody;
+    let hashOk;
+    let version;
+    /* 1. Supabase 시도 (device_token 인증 — bundle endpoint 가 401 요구) */
+    try {
+        const cfg = loadConfig();
+        const bundleRes = await fetchPersonaBundle(SERVER_BASE_URL, slug, cfg.auth?.deviceToken);
+        rawBody = bundleRes.bundle.body;
+        hashOk = bundleRes.hash_ok;
+        version = bundleRes.bundle.version;
+        const parsed = parseMarkdownWithFrontmatter(rawBody);
+        if (parsed) {
+            supabaseFm = parsed.frontmatter;
+            supabaseBody = parsed.body;
+        }
+        else {
+            // frontmatter 없는 레거시 body · frontmatter 없이 그대로
+            supabaseBody = rawBody;
+        }
+    }
+    catch {
+        // Supabase 실패는 조용히 override 로 fallback
+    }
+    /* 2. 로컬 override */
+    const overrideFm = readLocalOverride(slug);
+    if (!supabaseFm && !overrideFm) {
+        // Supabase body 는 있지만 frontmatter 없고 override 도 없음 → 페르소나 스크리너 쓸 수 없음
+        if (supabaseBody) {
+            return {
+                slug,
+                frontmatter: {
+                    persona: slug,
+                    version: version ?? "unknown",
+                },
+                promptBody: supabaseBody,
+                source: "supabase",
+                rawBody,
+                hashOk,
+                version,
+            };
+        }
+        return null;
+    }
+    // override 가 있으면 supabase fm 위에 얹기 (override 가 우선)
+    const merged = overrideFm
+        ? { ...(supabaseFm ?? { persona: slug, version: version ?? "override" }), ...overrideFm }
+        : supabaseFm;
+    const source = overrideFm && supabaseFm
+        ? "mixed"
+        : overrideFm
+            ? "local-override"
+            : "supabase";
+    return {
+        slug,
+        frontmatter: merged,
+        promptBody: supabaseBody,
+        source,
+        rawBody,
+        hashOk,
+        version,
+    };
+}
+function readLocalOverride(slug) {
+    const yamlPath = path.join(OVERRIDE_DIR, `${slug}.yaml`);
+    const ymlPath = path.join(OVERRIDE_DIR, `${slug}.yml`);
+    const mdPath = path.join(OVERRIDE_DIR, `${slug}.md`);
+    const candidates = [yamlPath, ymlPath, mdPath];
+    for (const p of candidates) {
+        if (!fs.existsSync(p))
+            continue;
+        try {
+            const raw = fs.readFileSync(p, "utf8");
+            const frontmatter = p.endsWith(".md")
+                ? parseMarkdownWithFrontmatter(raw)?.frontmatter ?? null
+                : parseYamlAsFrontmatter(raw);
+            if (!frontmatter)
+                continue;
+            const res = PersonaFrontmatterSchema.safeParse({ persona: slug, version: "override", ...frontmatter });
+            if (!res.success) {
+                throw new Error(`Override frontmatter validation 실패 · ${slug}: ${formatZodError(res.error)}`);
+            }
+            return res.data;
+        }
+        catch (e) {
+            console.warn(`[personas] override 로드 실패 (${p}): ${String(e)}`);
+        }
+    }
+    return null;
+}
+export function parseMarkdownWithFrontmatter(body) {
+    const trimmed = body.trimStart();
+    if (!trimmed.startsWith("---"))
+        return null;
+    const parsed = matter(body);
+    const fmRaw = parsed.data;
+    if (!fmRaw || Object.keys(fmRaw).length === 0)
+        return null;
+    const res = PersonaFrontmatterSchema.safeParse(fmRaw);
+    if (!res.success) {
+        throw new Error(`Persona frontmatter validation 실패: ${formatZodError(res.error)}`);
+    }
+    return { frontmatter: res.data, body: parsed.content };
+}
+function parseYamlAsFrontmatter(raw) {
+    // gray-matter 내부의 js-yaml 재사용 · 단독 yaml 을 "---\n...\n---" 로 감싸서 파싱
+    const wrapped = `---\n${raw.trim()}\n---\n`;
+    const parsed = matter(wrapped);
+    return parsed.data;
+}
+function formatZodError(err) {
+    return err.issues
+        .map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`)
+        .join(" · ");
+}
+export { OVERRIDE_DIR as PERSONA_OVERRIDE_DIR };
+//# sourceMappingURL=loader.js.map

package/dist/server/personas/loader.js.map

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