@nomadamas/k-skill 0.9.2 → 0.10.0

package/skills/government-bond-analysis/scripts/news.mjs

@@ -0,0 +1,113 @@
+import { date, sha256 } from './core.mjs';
+const sourceTypes = new Set(['market-close', 'market-update', 'official-release', 'headline']);
+const directions = new Set(['higher', 'lower', 'mixed', 'flat', 'context']);
+const relations = new Set(['explicit', 'contextual']);
+const clean = (value, name, max, min = 1) => {
+    if (typeof value !== 'string' || value.trim().length < min || value.length > max || /[\u0000-\u001f\u007f]/.test(value))
+        throw Error(`Invalid news ${name}`);
+    return value;
+};
+const instant = (value, name) => {
+    const text = clean(value, name, 40), time = Date.parse(text);
+    if (!Number.isFinite(time) || new Date(time).toISOString() !== text)
+        throw Error(`Invalid news ${name}`);
+    return text;
+};
+const kstDate = (instantValue) => {
+    const parts = new Intl.DateTimeFormat('en-CA', { timeZone: 'Asia/Seoul', year: 'numeric', month: '2-digit', day: '2-digit' }).formatToParts(new Date(instantValue));
+    const pick = (type) => parts.find(p => p.type === type)?.value ?? '';
+    return date(`${pick('year')}-${pick('month')}-${pick('day')}`);
+};
+const acceptedHost = (hostname) => ['news.einfomax.co.kr', 'kr.investing.com', 'www.investing.com', 'investing.com'].includes(hostname) || ['bok.or.kr', 'moef.go.kr', 'federalreserve.gov', 'treasury.gov', 'kostat.go.kr'].some(x => hostname === x || hostname.endsWith(`.${x}`));
+const fingerprint = (a) => sha256(JSON.stringify(a));
+export function newsRead(raw) {
+    if (raw.length > 100_000)
+        throw Error('News evidence exceeds 100 KB character limit');
+    const doc = JSON.parse(raw);
+    if (!doc || typeof doc !== 'object' || Array.isArray(doc) || doc.version !== 1)
+        throw Error('Unsupported news evidence');
+    if (Object.keys(doc).some(k => !['version', 'observationDate', 'retrievedAt', 'articles'].includes(k)))
+        throw Error('Unknown news evidence field');
+    const observationDate = date(clean(doc.observationDate, 'observationDate', 10)), retrievedAt = instant(doc.retrievedAt, 'retrievedAt');
+    if (!Array.isArray(doc.articles) || doc.articles.length < 1 || doc.articles.length > 5)
+        throw Error('News evidence requires 1..5 articles');
+    const articles = doc.articles.map((value, index) => {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            throw Error(`Invalid news article ${index + 1}`);
+        const x = value;
+        if (Object.keys(x).some(k => !['publisher', 'title', 'url', 'publishedAt', 'sourceType', 'marketDirection', 'relation', 'factor', 'evidenceSummary', 'sourceFingerprint'].includes(k)))
+            throw Error(`Unknown news article field ${index + 1}`);
+        const publisher = clean(x.publisher, 'publisher', 80, 2), title = clean(x.title, 'title', 220, 5), publishedAt = instant(x.publishedAt, 'publishedAt'), factor = clean(x.factor, 'factor', 140, 2), evidenceSummary = clean(x.evidenceSummary, 'evidenceSummary', 280, 20);
+        if (typeof x.sourceType !== 'string' || !sourceTypes.has(x.sourceType) || typeof x.marketDirection !== 'string' || !directions.has(x.marketDirection) || typeof x.relation !== 'string' || !relations.has(x.relation))
+            throw Error(`Invalid news classification ${index + 1}`);
+        let parsed;
+        try {
+            parsed = new URL(clean(x.url, 'url', 2048));
+        }
+        catch {
+            throw Error(`Invalid news URL ${index + 1}`);
+        }
+        const host = parsed.hostname.toLowerCase();
+        if (parsed.protocol !== 'https:' || parsed.username || parsed.password || parsed.port || !acceptedHost(host))
+            throw Error(`Unapproved news host ${index + 1}`);
+        if ((host === 'news.einfomax.co.kr' && publisher !== '연합인포맥스') || ((host === 'investing.com' || host.endsWith('.investing.com')) && publisher !== 'Investing.com'))
+            throw Error(`Publisher/host mismatch ${index + 1}`);
+        if (Date.parse(publishedAt) > Date.parse(retrievedAt) || kstDate(publishedAt) !== observationDate)
+            throw Error(`News date alignment mismatch ${index + 1}`);
+        const articleBase = { publisher, title, url: parsed.toString(), publishedAt, sourceType: x.sourceType, marketDirection: x.marketDirection, relation: x.relation, factor, evidenceSummary };
+        const sourceFingerprint = fingerprint(articleBase);
+        if (x.sourceFingerprint !== undefined && x.sourceFingerprint !== sourceFingerprint)
+            throw Error(`News fingerprint mismatch ${index + 1}`);
+        if (articleBase.sourceType === 'official-release' && (articleBase.marketDirection !== 'context' || articleBase.relation !== 'contextual'))
+            throw Error(`Official release must be contextual ${index + 1}`);
+        if (articleBase.relation === 'explicit' && articleBase.marketDirection === 'context')
+            throw Error(`Explicit article requires market direction ${index + 1}`);
+        return { ...articleBase, sourceFingerprint };
+    });
+    if (new Set(articles.map(x => x.url)).size !== articles.length || new Set(articles.map(x => x.sourceFingerprint)).size !== articles.length)
+        throw Error('Duplicate news article');
+    return { version: 1, observationDate, retrievedAt, articles };
+}
+function direction(a) {
+    if (!a.changes)
+        return null;
+    const short = a.changes[1], long = a.changes[3], eps = 1e-7;
+    if (Math.abs(short) < eps && Math.abs(long) < eps)
+        return 'flat';
+    if (short > eps && long > eps)
+        return 'higher';
+    if (short < -eps && long < -eps)
+        return 'lower';
+    return 'mixed';
+}
+export function analyzeNews(evidence, a) {
+    const curveDirection = direction(a);
+    if (!evidence)
+        return { status: 'DISABLED', confidence: null, curveDirection, commentary: [], eligible: [], context: [], excluded: [], notes: [] };
+    const normalized = newsRead(JSON.stringify(evidence));
+    if (!a.current.actual || normalized.observationDate !== a.current.actual)
+        throw Error('News observation date must equal the current common observation date');
+    const context = normalized.articles.filter(x => x.relation === 'contextual'), eligible = curveDirection ? normalized.articles.filter(x => x.relation === 'explicit' && x.marketDirection === curveDirection) : [];
+    const excluded = normalized.articles.filter(x => x.relation === 'explicit' && x.marketDirection !== curveDirection), notes = [];
+    if (excluded.length)
+        notes.push(`${excluded.length}개 기사는 관측된 3Y·10Y 방향과 불일치하여 원인 코멘트에서 제외`);
+    let status = 'UNATTRIBUTED', confidence = null;
+    if (eligible.length) {
+        status = 'SOURCED';
+        confidence = eligible.some(x => x.sourceType === 'market-close' && new URL(x.url).hostname === 'news.einfomax.co.kr') ? 'HIGH' : new Set(eligible.map(x => new URL(x.url).hostname)).size >= 2 ? 'MEDIUM' : 'LOW';
+    }
+    else if (context.length)
+        status = 'CONTEXT_ONLY';
+    const commentary = eligible.slice(0, 3).map(x => `시장 배경: ${x.factor} (${x.publisher} 「${x.title}」).`);
+    if (status === 'CONTEXT_ONLY')
+        commentary.push('같은 관측일의 공식 발표는 확인했지만 시장 움직임의 직접 원인으로 연결하지 않았다.');
+    if (status === 'UNATTRIBUTED')
+        commentary.push('관측 방향과 날짜가 일치하는 근거 기사를 확인하지 못했다.');
+    return { status, confidence, curveDirection, commentary, eligible, context, excluded, notes };
+}
+export function newsTemplate(observationDate, retrievedAt) {
+    date(observationDate);
+    instant(retrievedAt, 'retrievedAt');
+    const publishedAt = new Date(`${observationDate}T00:00:00+09:00`).toISOString();
+    return JSON.stringify({ version: 1, observationDate, retrievedAt, articles: [{ publisher: '연합인포맥스', title: '기사 제목을 입력', url: 'https://news.einfomax.co.kr/news/articleView.html?idxno=0000000', publishedAt, sourceType: 'market-close', marketDirection: 'mixed', relation: 'explicit', factor: '기사에서 명시한 시장 배경을 짧게 의역', evidenceSummary: '기사에서 시장 배경을 설명한 근거를 20~280자로 의역' }] }, null, 2) + '\n';
+}

package/skills/government-bond-analysis/scripts/render.mjs

@@ -0,0 +1,120 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { analyze, TENORS } from './core.mjs';
+import { analyzeNews } from './news.mjs';
+const h = (s) => createHash('sha256').update(s).digest('hex');
+const esc = (s) => String(s).replace(/[&<>"']/g, c => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c]));
+const md = (s) => String(s).replace(/[\\`*_[\]<>]/g, '\\$&');
+const n = (v, d = 2) => v === null ? '—' : v.toFixed(d);
+const signed = (v) => v === null ? '—' : `${v > 0 ? '+' : ''}${v.toFixed(2)}`;
+const trend = (v) => v === null ? '판정 불가' : v > 0 ? '상승' : v < 0 ? '하락' : '보합';
+const spreadTrend = (v) => v === null ? '판정 불가' : v > 0 ? '확대' : v < 0 ? '축소' : '보합';
+export function marketCsv(p, a) {
+    const rows = ['구분,만기,현재 요청일,현재 관측일,현재 금리(%),비교 요청일,비교 관측일,비교 금리(%),변화(bp)'];
+    TENORS.forEach((t, i) => rows.push([
+        '금리', `${t}Y`, a.current.requested, a.current.actual ?? '', a.current.values?.[i] ?? '', a.previous.requested, a.previous.actual ?? '', a.previous.values?.[i] ?? '', a.changes?.[i] ?? ''
+    ].join(',')));
+    a.spreads.forEach(s => rows.push(['스프레드', s.name, a.current.requested, a.current.actual ?? '', s.current ?? '', a.previous.requested, a.previous.actual ?? '', s.previous ?? '', s.change ?? ''].join(',')));
+    return '\uFEFF' + rows.join('\r\n') + '\r\n';
+}
+export function brief(p, a, news = analyzeNews(p.newsEvidence, a)) {
+    const current = a.current.actual ?? '확인 불가', previous = a.previous.actual ?? '확인 불가';
+    const lines = [`# ${md(p.label)}`, ``, `- 상태: **${a.status}**`, `- 요청 기준일: ${p.asOf} / 사용 관측일: ${current}`,
+        `- 비교 기준일: ${p.base} / 사용 관측일: ${previous}`, ''];
+    if (a.changes && a.current.values && a.previous.values) {
+        const i3 = TENORS.indexOf(3), i5 = TENORS.indexOf(5), i10 = TENORS.indexOf(10), s103 = a.spreads.find(s => s.name === '10년−3년');
+        lines.push('## 핵심 변화', '', `- 국고채 3년은 ${signed(a.changes[i3])}bp ${trend(a.changes[i3])}, 5년은 ${signed(a.changes[i5])}bp ${trend(a.changes[i5])}, 10년은 ${signed(a.changes[i10])}bp ${trend(a.changes[i10])}.`, `- 10년−3년 스프레드는 ${n(s103.current)}bp이며 비교일보다 ${n(Math.abs(s103.change ?? 0))}bp ${spreadTrend(s103.change)}.`, `- 곡선 움직임: **${a.movement}**.`, '');
+    }
+    else
+        lines.push('## 결과 제한', '', '- 비교 가능한 여섯 만기의 공통 관측값이 없어 변화 계산과 문장 생성을 차단했습니다.', '');
+    if (news.status !== 'DISABLED')
+        lines.push('## 시장 배경', '', `- 뉴스 근거 상태: **${news.status}**${news.confidence ? ` / 신뢰도 **${news.confidence}**` : ''}`, ...news.commentary.map(x => `- ${md(x)}`), ...news.notes.map(x => `- 주의: ${md(x)}`), ...([...news.eligible.map(x => ({ label: '채택', article: x })), ...news.context.map(x => ({ label: '맥락', article: x })), ...news.excluded.map(x => ({ label: '제외', article: x }))].map(({ label, article: x }) => `- ${label} · ${md(x.publisher)} · ${md(x.title)} · ${x.publishedAt} · [원문](${x.url}) · 근거 SHA-256 ${x.sourceFingerprint}`)), '', '- 기사에서 전한 시장 해석을 출처와 함께 요약했으며, ECOS 수치만으로 인과관계를 확정하지 않는다.', '');
+    lines.push('## 검증 메모', '', ...(a.notes.length ? a.notes.map(x => `- ${md(x)}`) : ['- 결측·날짜 정렬 경고 없음.']), '', '## 출처', '', ...p.receipts.map(r => `- ${r.tenor}년: ${md(r.sourceId)} / ${md(r.statCode)}·${md(r.itemCode)} ${md(r.itemName)} / ${md(r.unit)}·${md(r.cycle)} / ${r.first ?? '없음'}~${r.last ?? '없음'} (${r.count}건) / ${r.status} / 원문 SHA-256 ${r.rawSha256.join(', ') || '없음'}${r.sourceUrl ? ` / ${r.sourceUrl}` : ''}`), '', '## 해석 범위', '', '- 이 결과는 공식 통계의 기간 비교다. 실시간 호가, 원인 추정, 금리 전망 또는 투자 권유가 아니다.', '');
+    return lines.join('\n') + '\n';
+}
+function chart(a) {
+    if (!a.current.values || !a.previous.values)
+        return '<div class="empty">공통 관측값이 없어 차트를 생성하지 않았습니다.</div>';
+    const all = [...a.current.values, ...a.previous.values], min = Math.min(...all) - .03, max = Math.max(...all) + .03, range = Math.max(max - min, .1);
+    const x = (i) => 75 + i * (500 / (TENORS.length - 1)), y = (v) => 260 - (v - min) / range * 190;
+    const path = (values) => values.map((v, i) => `${i ? 'L' : 'M'} ${x(i)} ${y(v).toFixed(1)}`).join(' ');
+    const grid = [0, .25, .5, .75, 1].map(q => { const yy = 260 - q * 190, v = min + q * range; return `<line x1="62" y1="${yy}" x2="560" y2="${yy}"/><text x="54" y="${yy + 4}" text-anchor="end">${v.toFixed(2)}</text>`; }).join('');
+    const dots = (values, cls) => values.map((v, i) => `<circle class="${cls}" cx="${x(i)}" cy="${y(v)}" r="5"/>`).join('');
+    const labels = (values, other, cls) => values.map((v, i) => { const above = y(v) <= y(other[i]), baseline = y(v) + (above ? -14 : 22), top = baseline - 13; return `<g class="value-label ${cls}"><rect x="${x(i) - 24}" y="${top}" width="48" height="18" rx="5"/><text x="${x(i)}" y="${baseline}" text-anchor="middle">${v.toFixed(3)}</text></g>`; }).join('');
+    return `<svg viewBox="0 0 620 320" role="img" aria-label="국고채 수익률곡선 비교"><g class="grid">${grid}</g><path class="line prior" d="${path(a.previous.values)}"/><path class="line now" d="${path(a.current.values)}"/>${dots(a.previous.values, 'prior')}${dots(a.current.values, 'now')}${labels(a.previous.values, a.current.values, 'prior')}${labels(a.current.values, a.previous.values, 'now')}<g class="axis">${TENORS.map((t, i) => `<text x="${x(i)}" y="288" text-anchor="middle">${t}년</text>`).join('')}</g><g class="legend"><circle cx="405" cy="26" r="5" class="now"/><text x="416" y="30">현재</text><circle cx="485" cy="26" r="5" class="prior"/><text x="496" y="30">비교</text></g></svg>`;
+}
+export function html(p, a, news = analyzeNews(p.newsEvidence, a)) {
+    const statusClass = a.status.toLowerCase();
+    const allInput = p.receipts.every(r => r.status === 'input'), allEcos = p.receipts.every(r => r.status !== 'input');
+    const sourceFooter = allInput ? '출처: 사용자 제공 CSV · 연% · 일별 입력자료. 원자료 성격은 제공자가 확인해야 합니다.' : allEcos ? '출처: 한국은행 ECOS 817Y002 · 연% · 일별 공식 통계. 실시간 호가나 투자 권유가 아닙니다.' : '출처: 한국은행 ECOS 및 사용자 제공 CSV 혼합 자료. 각 만기의 출처를 확인해야 합니다.';
+    const rows = TENORS.map((t, i) => `<tr><td>${t}년</td><td>${n(a.previous.values?.[i] ?? null, 3)}</td><td>${n(a.current.values?.[i] ?? null, 3)}</td><td class="${(a.changes?.[i] ?? 0) > 0 ? 'up' : (a.changes?.[i] ?? 0) < 0 ? 'down' : ''}">${signed(a.changes?.[i] ?? null)}</td></tr>`).join('');
+    const spreadRows = a.spreads.map(s => `<tr><td>${esc(s.name)}</td><td>${n(s.previous)}</td><td>${n(s.current)}</td><td>${signed(s.change)}</td></tr>`).join('');
+    const sourceRows = p.receipts.map(r => `<tr><td>${r.tenor}년</td><td>${esc(r.sourceId)}</td><td>${esc(r.statCode)} / ${esc(r.itemCode)}<br><span class="sub">${esc(r.itemName)}</span></td><td>${esc(r.unit)} / ${esc(r.cycle)}</td><td>${esc(r.first ?? '없음')}<br>${esc(r.last ?? '없음')} · ${r.count}건</td><td>${esc(r.retrievedAt)}<br><strong>${esc(r.status)}</strong></td><td>${r.sourceUrl ? `<a href="${esc(r.sourceUrl)}" rel="noreferrer">공식 원천</a>` : '로컬 입력'}</td></tr>`).join('');
+    const newsRows = [...news.eligible.map(x => ({ label: '채택', article: x })), ...news.context.map(x => ({ label: '맥락', article: x })), ...news.excluded.map(x => ({ label: '제외', article: x }))];
+    const newsSection = news.status === 'DISABLED' ? '' : `<section class="card" style="margin-top:18px"><h2>시장 배경</h2><div class="metric">${news.status}${news.confidence ? ` · ${news.confidence}` : ''}</div><ul class="notes">${[...news.commentary, ...news.notes.map(x => `주의: ${x}`)].map(x => `<li>${esc(x)}</li>`).join('')}</ul><div class="scroll"><table class="news-table"><colgroup><col class="news-result"><col class="news-publisher"><col class="news-title"><col class="news-time"><col class="news-summary"></colgroup><thead><tr><th>판정</th><th>매체</th><th>기사</th><th>게시 UTC</th><th>근거 요약</th></tr></thead><tbody>${newsRows.map(({ label, article: x }) => `<tr><td>${label}</td><td>${esc(x.publisher)}</td><td><a href="${esc(x.url)}" rel="noreferrer">${esc(x.title)}</a></td><td>${esc(x.publishedAt)}</td><td>${esc(x.evidenceSummary)}</td></tr>`).join('')}</tbody></table></div><p class="sub">기사에서 전한 시장 해석을 출처와 함께 요약했으며, ECOS 수치만으로 인과관계를 확정하지 않습니다.</p></section>`;
+    return `<!doctype html><html lang="ko"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${esc(p.label)}</title><style>
+  :root{--ink:#172033;--muted:#687386;--paper:#f5f3ee;--card:#fff;--blue:#165dff;--orange:#e97522;--line:#dfe4eb;--good:#17745c;--warn:#a15c00;--bad:#a9363e}*{box-sizing:border-box}body{margin:0;background:var(--paper);color:var(--ink);font:14px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif}.wrap{max-width:1240px;margin:0 auto;padding:36px 22px 56px}header{display:flex;justify-content:space-between;gap:20px;align-items:flex-start;margin-bottom:20px}h1{font-size:30px;line-height:1.16;margin:4px 0 8px;letter-spacing:-.03em}.eyebrow{font-size:12px;font-weight:700;color:var(--blue);letter-spacing:.08em}.meta{color:var(--muted);font-size:13px}.badge{padding:7px 12px;border-radius:999px;font-size:13px;font-weight:800;background:#e8f5f0;color:var(--good)}.badge.incomplete{background:#fff0d9;color:var(--warn)}.badge.blocked{background:#fae8e9;color:var(--bad)}.grid2{display:grid;grid-template-columns:minmax(0,1.3fr) minmax(340px,.7fr);gap:16px}.card{min-width:0;background:var(--card);border:1px solid var(--line);border-radius:15px;padding:19px;box-shadow:0 8px 24px #1a243008}.scroll{overflow-x:auto}h2{font-size:17px;margin:0 0 13px}table{width:100%;border-collapse:collapse;font-size:13px;font-variant-numeric:tabular-nums}th,td{text-align:right;padding:8px 7px;border-bottom:1px solid var(--line);vertical-align:middle}th:first-child,td:first-child{text-align:left}th{color:var(--muted);font-size:11px;font-weight:700;line-height:1.25;white-space:nowrap;text-transform:uppercase}.rates-table td,.spread-table td{white-space:nowrap}.news-table,.source-table{table-layout:fixed;min-width:920px}.news-table th,.news-table td,.source-table th,.source-table td{text-align:left;overflow-wrap:break-word}.news-table .news-result{width:7%}.news-table .news-publisher{width:12%}.news-table .news-title{width:24%}.news-table .news-time{width:18%}.news-table .news-summary{width:39%}.source-table .source-tenor{width:7%}.source-table .source-provider{width:18%}.source-table .source-code{width:21%}.source-table .source-unit{width:10%}.source-table .source-range{width:18%}.source-table .source-retrieved{width:18%}.source-table .source-link{width:8%}.metric{font-size:23px;line-height:1.25;font-weight:800}.sub{color:var(--muted);font-size:12px}.notes{margin:0;padding-left:19px}.notes li+li{margin-top:6px}svg{display:block;width:100%;height:auto}.grid line{stroke:#e5e9ef}.grid text,.axis text,.legend text{fill:#687386;font-size:11px}.line{fill:none;stroke-width:2.5}.line.now{stroke:var(--blue)}.line.prior{stroke:var(--orange);stroke-dasharray:7 5}circle.now{fill:var(--blue)}circle.prior{fill:var(--orange)}.value-label rect{fill:#fff;stroke-width:1}.value-label text{font-size:10.5px;font-weight:750;font-variant-numeric:tabular-nums}.value-label.now rect{stroke:#9db8ff}.value-label.now text{fill:#174fc5}.value-label.prior rect{stroke:#f0bc95}.value-label.prior text{fill:#a84e12}.empty{padding:80px 20px;text-align:center;color:var(--muted)}footer{margin-top:16px;color:var(--muted);font-size:11px}@media(max-width:820px){.grid2{grid-template-columns:1fr}header{display:block}.badge{display:inline-block;margin-top:12px}}@media(max-width:560px){.wrap{padding:24px 12px 40px}.card{padding:15px}h1{font-size:25px}}
+  </style></head><body><main class="wrap"><header><div><div class="eyebrow">KOREAN RATES · VERIFIED SNAPSHOT</div><h1>${esc(p.label)}</h1><div class="meta">요청 ${esc(p.base)} → ${esc(p.asOf)} · 관측 ${esc(a.previous.actual ?? '없음')} → ${esc(a.current.actual ?? '없음')}</div></div><div class="badge ${statusClass}">${a.status}</div></header><section class="grid2"><article class="card"><h2>수익률곡선</h2>${chart(a)}</article><article class="card"><h2>곡선 판정</h2><div class="metric">${esc(a.movement)}</div><p class="sub">3년과 10년 변화 및 10년−3년 스프레드를 기준으로 한 기계적 분류</p><table class="spread-table"><thead><tr><th>구간</th><th>비교</th><th>현재</th><th>변화(bp)</th></tr></thead><tbody>${spreadRows}</tbody></table></article></section><section class="card" style="margin-top:16px"><h2>만기별 금리</h2><table class="rates-table"><thead><tr><th>만기</th><th>비교일(%)</th><th>현재일(%)</th><th>변화(bp)</th></tr></thead><tbody>${rows}</tbody></table></section>${newsSection}<section class="card" style="margin-top:16px"><h2>검증 메모</h2><ul class="notes">${(a.notes.length ? a.notes : ['결측·날짜 정렬 경고 없음.']).map(x => `<li>${esc(x)}</li>`).join('')}</ul></section><section class="card" style="margin-top:16px"><h2>원천·검증 추적</h2><div class="scroll"><table class="source-table" data-provenance="true"><colgroup><col class="source-tenor"><col class="source-provider"><col class="source-code"><col class="source-unit"><col class="source-range"><col class="source-retrieved"><col class="source-link"></colgroup><thead><tr><th>만기</th><th>제공기관</th><th>통계/항목</th><th>단위/주기</th><th>관측 범위</th><th>수집 UTC/방식</th><th>링크</th></tr></thead><tbody>${sourceRows}</tbody></table></div></section><footer>${esc(sourceFooter)}</footer></main></body></html>`;
+}
+const artifactNames = ['market-table.csv', 'brief.md', 'report.html', 'evidence.mjson', 'status.mjson'];
+function statusJson(p, a, news) { return JSON.stringify({ status: a.status, notes: a.notes, usable: a.status === 'READY', news: { status: news.status, confidence: news.confidence, curveDirection: news.curveDirection, notes: news.notes, sources: [...news.eligible.map(x => ({ disposition: 'eligible', ...x })), ...news.context.map(x => ({ disposition: 'context', ...x })), ...news.excluded.map(x => ({ disposition: 'excluded', ...x }))].map(({ disposition, publisher, title, url, publishedAt, sourceFingerprint }) => ({ disposition, publisher, title, url, publishedAt, sourceFingerprint })) }, sources: p.receipts.map(({ tenor, status, sourceId, statCode, itemCode, unit, cycle, count, first, last, retrievedAt, rawSha256 }) => ({ tenor, status, sourceId, statCode, itemCode, unit, cycle, count, first, last, retrievedAt, rawSha256 })) }, null, 2) + '\n'; }
+export async function writeArtifacts(out, p) {
+    const a = analyze(p), news = analyzeNews(p.newsEvidence, a), parent = dirname(out), stage = join(parent, `.${basename(out)}.stage-${process.pid}-${randomUUID()}`);
+    await mkdir(parent, { recursive: true });
+    try {
+        await stat(out);
+        throw Error(`Output path already exists: ${out}`);
+    }
+    catch (e) {
+        if (e.code !== 'ENOENT')
+            throw e;
+    }
+    try {
+        await mkdir(stage, { recursive: false });
+        const evidence = JSON.stringify(p, null, 2) + '\n';
+        const files = { 'market-table.csv': marketCsv(p, a), 'brief.md': brief(p, a, news), 'report.html': html(p, a, news), 'evidence.mjson': evidence, 'status.mjson': statusJson(p, a, news) };
+        const manifest = { version: 5, engine: p.engine, status: a.status, newsStatus: news.status, evidenceSha256: h(evidence), files: {} };
+        for (const name of artifactNames) {
+            const content = files[name];
+            if (/NaN|undefined/.test(content))
+                throw Error(`${name}: invalid token`);
+            manifest.files[name] = h(content);
+            await writeFile(join(stage, name), content);
+        }
+        await writeFile(join(stage, 'manifest.mjson'), JSON.stringify(manifest, null, 2) + '\n');
+        await validateArtifacts(stage);
+        await rename(stage, out);
+        return manifest;
+    }
+    catch (e) {
+        await rm(stage, { recursive: true, force: true });
+        throw e;
+    }
+}
+export async function validateArtifacts(dir) {
+    const manifest = JSON.parse(await readFile(join(dir, 'manifest.mjson'), 'utf8'));
+    if (manifest.version !== 5 || manifest.engine !== 'korean-interest-rate-analysis/5' || !manifest.files || typeof manifest.files !== 'object')
+        throw Error('Unsupported manifest');
+    const expected = [...artifactNames].sort(), declared = Object.keys(manifest.files).sort(), present = (await readdir(dir)).sort();
+    if (JSON.stringify(declared) !== JSON.stringify(expected) || JSON.stringify(present) !== JSON.stringify([...expected, 'manifest.mjson'].sort()) || Object.values(manifest.files).some(x => typeof x !== 'string' || !/^[a-f0-9]{64}$/.test(x)) || !/^[a-f0-9]{64}$/.test(manifest.evidenceSha256))
+        throw Error('Manifest file contract mismatch');
+    const evidence = await readFile(join(dir, 'evidence.mjson'), 'utf8');
+    if (h(evidence) !== manifest.evidenceSha256)
+        throw Error('Evidence hash mismatch');
+    const p = JSON.parse(evidence), a = analyze(p), news = analyzeNews(p.newsEvidence, a);
+    if (a.status !== manifest.status || news.status !== manifest.newsStatus)
+        throw Error('Status mismatch');
+    for (const [name, digest] of Object.entries(manifest.files)) {
+        const content = await readFile(join(dir, name), 'utf8');
+        if (h(content) !== digest)
+            throw Error(`${name}: hash mismatch`);
+    }
+    const mdFile = await readFile(join(dir, 'brief.md'), 'utf8'), csv = await readFile(join(dir, 'market-table.csv'), 'utf8'), page = await readFile(join(dir, 'report.html'), 'utf8'), status = await readFile(join(dir, 'status.mjson'), 'utf8');
+    if (mdFile !== brief(p, a, news) || csv !== marketCsv(p, a) || page !== html(p, a, news) || status !== statusJson(p, a, news))
+        throw Error('Rendered artifact is not reproducible');
+    if (a.status === 'READY' && (!page.includes('<svg') || csv.trim().split(/\r?\n/).length !== 1 + TENORS.length + a.spreads.length || !mdFile.includes('## 핵심 변화') || !page.includes('data-provenance="true"') || !page.includes('class="value-label') || page.includes('원문 SHA-256') || p.receipts.some(r => r.sourceUrl && !page.includes(r.sourceUrl))))
+        throw Error('READY output contract is incomplete');
+    if (a.status !== 'READY' && !mdFile.includes('## 결과 제한'))
+        throw Error('Non-ready output must state its limitation');
+}

package/skills/government-bond-analysis/scripts/schedule.mjs

@@ -0,0 +1,96 @@
+import { date, days, shift } from './core.mjs';
+const hosts = {
+    KR: { auction: ['ktb.moef.go.kr'], policy: ['bok.or.kr', 'www.bok.or.kr'] },
+    US: { auction: ['home.treasury.gov', 'www.treasurydirect.gov', 'treasurydirect.gov'], policy: ['www.federalreserve.gov', 'federalreserve.gov'] }
+};
+const text = (value, max) => typeof value === 'string' && value.trim().length > 0 && value.length <= max && !/[\u0000-\u001f\u007f]/.test(value);
+const iso = (value) => typeof value === 'string' && Number.isFinite(Date.parse(value)) && new Date(value).toISOString() === value;
+function quotedDate(quoted, eventDate, excerpt) {
+    if (!excerpt.includes(quoted))
+        return false;
+    const weekday = quoted.match(/^(Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday),/);
+    if (weekday && new Intl.DateTimeFormat('en-US', { timeZone: 'UTC', weekday: 'long' }).format(new Date(`${eventDate}T00:00:00Z`)) !== weekday[1])
+        return false;
+    const isoOrDots = quoted.match(/^(\d{4})[-.](\d{2})[-.](\d{2})\.?$/);
+    if (isoOrDots)
+        return `${isoOrDots[1]}-${isoOrDots[2]}-${isoOrDots[3]}` === eventDate;
+    const ko = quoted.match(/^(\d{1,2})월\s*(\d{1,2})일$/);
+    if (ko)
+        return excerpt.includes(eventDate.slice(0, 4)) && Number(ko[1]) === Number(eventDate.slice(5, 7)) && Number(ko[2]) === Number(eventDate.slice(8));
+    const fed = quoted.match(/^([A-Z][a-z]+)\s+(\d{1,2})-(\d{1,2})$/);
+    if (fed) {
+        if (Number(fed[2]) >= Number(fed[3]))
+            return false;
+        const parsed = Date.parse(`${fed[1]} ${fed[3]}, ${eventDate.slice(0, 4)} GMT`);
+        return excerpt.includes(eventDate.slice(0, 4)) && Number.isFinite(parsed) && new Date(parsed).toISOString().slice(0, 10) === eventDate;
+    }
+    const english = Date.parse(`${quoted} GMT`);
+    return Number.isFinite(english) && new Date(english).toISOString().slice(0, 10) === eventDate;
+}
+function validateEvent(e, anchorDate) {
+    if (!e || typeof e !== 'object' || !['KR', 'US'].includes(e.market) || !['auction', 'policy'].includes(e.kind) || date(e.date) !== e.date || e.date < anchorDate || e.date > shift(anchorDate, 45))
+        throw Error('Schedule event date, market, or kind mismatch');
+    if (!text(e.sourceUrl, 500) || !text(e.sourceExcerpt, 500) || !text(e.sourceDateText, 80))
+        throw Error('Schedule source text missing or unsafe');
+    let host;
+    try {
+        const url = new URL(e.sourceUrl);
+        if (url.protocol !== 'https:' || url.username || url.password || url.toString() !== e.sourceUrl || /[\s()<>{}]/.test(e.sourceUrl))
+            throw Error();
+        host = url.hostname.toLowerCase();
+    }
+    catch {
+        throw Error('Schedule source URL must be official HTTPS');
+    }
+    if (!hosts[e.market][e.kind].includes(host))
+        throw Error('Schedule source host does not match market and kind');
+    if (!quotedDate(e.sourceDateText, e.date, e.sourceExcerpt))
+        throw Error('Schedule quoted date does not match event date');
+    if (e.kind === 'auction') {
+        if (!Number.isInteger(e.tenor) || ![2, 3, 5, 7, 10, 20, 30, 50].includes(e.tenor) || (e.market === 'US' && !new RegExp(`\\b${e.tenor}-Year (?:NOTE|BOND)\\b`, 'i').test(e.sourceExcerpt)) || (e.market === 'KR' && !e.sourceExcerpt.includes(`${e.tenor}년물`)))
+            throw Error('Schedule auction tenor or source marker mismatch');
+        if (e.market === 'US') {
+            const dates = [...e.sourceExcerpt.matchAll(/(?:Monday|Tuesday|Wednesday|Thursday|Friday),\s+[A-Z][a-z]+\s+\d{1,2},\s+\d{4}/g)].map(match => match[0]);
+            if (/tentative/i.test(e.sourceUrl) && dates.length < 3)
+                throw Error('Tentative U.S. auction row must include announcement, auction, and settlement dates');
+            if (dates.length >= 3 && e.sourceDateText !== dates[1])
+                throw Error('Schedule U.S. auction date must be the second date in the official row');
+        }
+    }
+    else if (e.tenor !== undefined || (e.market === 'KR' && !/통화정책방향|금융통화위원회/.test(e.sourceExcerpt)) || (e.market === 'US' && !/FOMC|Federal Open Market Committee/.test(e.sourceExcerpt)))
+        throw Error('Schedule policy source marker mismatch');
+}
+export function readSchedule(raw, anchorDate) {
+    if (raw.length > 100_000)
+        throw Error('Schedule evidence exceeds 100 KB');
+    const evidence = JSON.parse(raw);
+    validateSchedule(evidence, anchorDate);
+    return evidence;
+}
+export function validateSchedule(evidence, anchorDate) {
+    date(anchorDate);
+    if (!evidence || typeof evidence !== 'object' || evidence.version !== 1 || evidence.anchorDate !== anchorDate || !iso(evidence.checkedAt) || !Array.isArray(evidence.events) || evidence.events.length > 30)
+        throw Error('Schedule evidence identity or size mismatch');
+    const checkedDate = evidence.checkedAt.slice(0, 10);
+    if (days(checkedDate, anchorDate) < -1 || days(checkedDate, anchorDate) > 14)
+        throw Error('Schedule verification time is too far from report date');
+    const seen = new Set();
+    for (const e of evidence.events) {
+        validateEvent(e, anchorDate);
+        const key = `${e.date}/${e.market}/${e.kind}/${e.tenor ?? ''}`;
+        if (seen.has(key))
+            throw Error('Duplicate schedule event');
+        seen.add(key);
+    }
+}
+export function analyzeSchedule(evidence, anchorDate) {
+    date(anchorDate);
+    if (!evidence)
+        return { status: 'UNVERIFIED', anchorDate, checkedAt: null, events: [], note: '공식 일정 자료를 확인하지 못해 날짜를 표시하지 않았습니다.' };
+    validateSchedule(evidence, anchorDate);
+    const label = (e) => e.kind === 'policy' ? e.market === 'KR' ? '한국은행 통화정책방향 결정회의' : 'FOMC 금리 결정' : e.market === 'KR' ? `국고채 ${e.tenor}년물 입찰` : `미국 국채 ${e.tenor}년물 입찰${/tentative/i.test(e.sourceUrl) ? ' (잠정)' : ''}`;
+    const events = [...evidence.events].sort((a, b) => a.date.localeCompare(b.date) || a.market.localeCompare(b.market) || a.kind.localeCompare(b.kind) || (a.tenor ?? 0) - (b.tenor ?? 0));
+    const limited = events.filter(e => events.filter(x => x.market === e.market && (x.date < e.date || (x.date === e.date && events.indexOf(x) <= events.indexOf(e)))).length <= 4).slice(0, 8).map(e => ({ ...e, label: label(e) }));
+    const markets = new Set(events.map(e => e.market));
+    return { status: markets.size === 2 ? 'VERIFIED' : 'PARTIAL', anchorDate, checkedAt: evidence.checkedAt, events: limited, note: markets.size === 2 ? '각 날짜는 해당 국가 현지일입니다. 예정 일정은 변경될 수 있으니 원문을 다시 확인하세요.' : markets.size === 1 ? `${markets.has('KR') ? '미국' : '한국'} 공식 일정은 확인되지 않았습니다. 표시 날짜는 해당 국가 현지일입니다.` : '조회 기간에 확인된 공식 일정이 없습니다.' };
+}

package/skills/government-bond-analysis/scripts/ust.mjs

@@ -0,0 +1,204 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { bp, classify, date, days, shift, TENORS } from './core.mjs';
+const FIELDS = {
+    2: 'BC_2YEAR', 3: 'BC_3YEAR', 5: 'BC_5YEAR',
+    10: 'BC_10YEAR', 20: 'BC_20YEAR', 30: 'BC_30YEAR'
+};
+export const UST_SOURCE = 'U.S. Treasury Daily Treasury Par Yield Curve Rates';
+export const UST_SOURCE_PAGE = 'https://home.treasury.gov/resource-center/data-chart-center/interest-rates/TextView?type=daily_treasury_yield_curve';
+export const UST_ENGINE = 'ktb-ust-rate-analysis/1';
+const digest = (raw) => createHash('sha256').update(raw).digest('hex');
+const cleanError = (error) => (error instanceof Error ? error.message : String(error)).replace(/[\r\n\t]+/g, ' ').slice(0, 240) || 'unknown error';
+export function ustMonthUrl(month) {
+    if (!/^\d{4}-(0[1-9]|1[0-2])$/.test(month))
+        throw Error('Invalid UST month');
+    return `https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=daily_treasury_yield_curve&field_tdr_date_value_month=${month.replace('-', '')}`;
+}
+function oneTag(xml, name) {
+    const matches = [...xml.matchAll(new RegExp(`<d:${name}(?:\\s[^>]*)?>([^<]*)<\\/d:${name}>`, 'g'))];
+    const nulls = [...xml.matchAll(new RegExp(`<d:${name}\\s+[^>]*m:null="true"[^>]*/>`, 'g'))];
+    if (matches.length + nulls.length !== 1)
+        throw Error(`UST XML field ${name} missing or duplicated`);
+    if (nulls.length)
+        return null;
+    return matches[0][1].trim();
+}
+export function parseUstXml(raw, month) {
+    if (raw.length > 5_000_000 || !raw.includes('<feed ') || !raw.includes('<title type="text">DailyTreasuryYieldCurveRateData</title>'))
+        throw Error('Invalid UST XML feed');
+    const entries = [...raw.matchAll(/<entry>([\s\S]*?)<\/entry>/g)];
+    if (!entries.length)
+        throw Error(`UST feed has no entries for ${month}`);
+    const rows = [];
+    const seen = new Set();
+    for (const [, entry] of entries) {
+        const props = [...entry.matchAll(/<m:properties>([\s\S]*?)<\/m:properties>/g)];
+        if (props.length !== 1)
+            throw Error('UST XML properties missing or duplicated');
+        const timestamp = oneTag(props[0][1], 'NEW_DATE');
+        if (!timestamp || !/^\d{4}-\d{2}-\d{2}T00:00:00$/.test(timestamp))
+            throw Error('Invalid UST observation date');
+        const observationDate = date(timestamp.slice(0, 10));
+        if (!observationDate.startsWith(`${month}-`) || seen.has(observationDate))
+            throw Error('UST month/date mismatch or duplicate observation');
+        seen.add(observationDate);
+        const yields = {};
+        let complete = true;
+        for (const tenor of TENORS) {
+            const value = oneTag(props[0][1], FIELDS[tenor]);
+            if (value === null || value === '') {
+                complete = false;
+                continue;
+            }
+            if (!/^-?\d+(?:\.\d+)?$/.test(value))
+                throw Error(`Invalid UST ${tenor}Y yield`);
+            const numeric = Number(value);
+            if (!Number.isFinite(numeric) || numeric < 0 || numeric > 50)
+                throw Error(`UST ${tenor}Y yield outside annual-percent bounds`);
+            yields[tenor] = numeric;
+        }
+        if (complete)
+            rows.push({ date: observationDate, yields });
+    }
+    return rows.sort((a, b) => a.date.localeCompare(b.date));
+}
+export function ustMonths(base, asOf, maxLag) {
+    date(base);
+    date(asOf);
+    if (base >= asOf || days(asOf, base) > 366)
+        throw Error('UST comparison dates must be ordered within 366 days');
+    if (!Number.isInteger(maxLag) || maxLag < 0 || maxLag > 14)
+        throw Error('UST maxLag must be 0..14');
+    const months = new Set();
+    for (const anchor of [base, asOf]) {
+        for (let d = shift(anchor, -maxLag); d <= anchor; d = shift(d, 1))
+            months.add(d.slice(0, 7));
+    }
+    return [...months].sort();
+}
+async function fetchUst(url, month, fetcher) {
+    let error = Error('UST request failed');
+    for (let attempt = 1; attempt <= 3; attempt++) {
+        try {
+            const response = await fetcher(url, { signal: AbortSignal.timeout(15_000), headers: { Accept: 'application/xml,text/xml' } });
+            if (!response.ok) {
+                if (response.status >= 400 && response.status < 500 && response.status !== 429)
+                    throw Error(`UST HTTP ${response.status} (fatal)`);
+                throw Error(`UST HTTP ${response.status}`);
+            }
+            const raw = await response.text();
+            if (raw.length > 5_000_000)
+                throw Error('UST response exceeds 5 MB');
+            parseUstXml(raw, month);
+            return raw;
+        }
+        catch (e) {
+            error = e instanceof Error ? e : Error(String(e));
+            if (error.message.endsWith('(fatal)'))
+                break;
+            if (attempt < 3)
+                await new Promise(resolve => setTimeout(resolve, 200 * attempt));
+        }
+    }
+    throw error;
+}
+async function writeUstCache(file, source) {
+    const temporary = `${file}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, JSON.stringify(source));
+        await rename(temporary, file);
+    }
+    catch (error) {
+        await rm(temporary, { force: true });
+        throw error;
+    }
+}
+export async function collectUst(base, asOf, maxLag, cacheDir, useCache = true, fetcher = fetch, now = new Date()) {
+    if (!Number.isFinite(now.getTime()))
+        throw Error('Invalid UST collection clock');
+    const sources = [];
+    for (const month of ustMonths(base, asOf, maxLag)) {
+        const url = ustMonthUrl(month), file = join(cacheDir, `ust-${month}.mjson`);
+        let cached = null;
+        if (useCache) {
+            try {
+                const candidate = JSON.parse(await readFile(file, 'utf8'));
+                const age = (now.getTime() - Date.parse(candidate.retrievedAt)) / 3_600_000;
+                if (candidate.month === month && candidate.url === url && candidate.status === 'live' && candidate.error === undefined && candidate.cacheAgeHours === undefined && candidate.sha256 === digest(candidate.raw) && Number.isFinite(age) && age >= 0 && age <= 168) {
+                    parseUstXml(candidate.raw, month);
+                    cached = { ...candidate, status: 'cache', cacheAgeHours: Math.round(age * 100) / 100 };
+                }
+            }
+            catch { /* invalid cache is ignored */ }
+        }
+        const usParts = new Intl.DateTimeFormat('en-US', { timeZone: 'America/New_York', year: 'numeric', month: '2-digit' }).formatToParts(now);
+        const currentUsMonth = `${usParts.find(p => p.type === 'year')?.value}-${usParts.find(p => p.type === 'month')?.value}`;
+        if (cached && cached.cacheAgeHours <= (month === currentUsMonth ? 6 : 24)) {
+            sources.push(cached);
+            continue;
+        }
+        try {
+            const raw = await fetchUst(url, month, fetcher);
+            const source = { month, url, retrievedAt: now.toISOString(), status: 'live', raw, sha256: digest(raw) };
+            sources.push(source);
+            if (useCache) {
+                try {
+                    await mkdir(cacheDir, { recursive: true });
+                    await writeUstCache(file, source);
+                }
+                catch { /* live data remains valid */ }
+            }
+        }
+        catch (e) {
+            if (cached)
+                sources.push(cached);
+            else
+                sources.push({ month, url, retrievedAt: now.toISOString(), status: 'failed', raw: '', sha256: '', error: cleanError(e) });
+        }
+    }
+    return { version: 1, engine: UST_ENGINE, base, asOf, maxLag, sources };
+}
+export function analyzeUst(packet) {
+    if (packet.version !== 1 || packet.engine !== UST_ENGINE || !Array.isArray(packet.sources))
+        throw Error('Unsupported UST evidence packet');
+    const expected = ustMonths(packet.base, packet.asOf, packet.maxLag);
+    if (packet.sources.length !== expected.length)
+        throw Error('UST source month count mismatch');
+    const rows = [];
+    let omittedIncompleteDates = 0;
+    for (let i = 0; i < expected.length; i++) {
+        const source = packet.sources[i];
+        if (!source || source.month !== expected[i] || source.url !== ustMonthUrl(source.month) || !['live', 'cache', 'failed'].includes(source.status) || !Number.isFinite(Date.parse(source.retrievedAt)) || new Date(source.retrievedAt).toISOString() !== source.retrievedAt)
+            throw Error('UST source identity or checksum mismatch');
+        if (source.status === 'failed') {
+            if (source.raw !== '' || source.sha256 !== '' || typeof source.error !== 'string' || !source.error || source.error.length > 240 || /[\r\n\t]/.test(source.error) || source.cacheAgeHours !== undefined)
+                throw Error('Invalid failed UST source receipt');
+            continue;
+        }
+        if (source.error !== undefined)
+            throw Error('Successful UST source cannot contain an error');
+        if (source.sha256 !== digest(source.raw))
+            throw Error('UST source checksum mismatch');
+        if (source.status === 'cache' && (!Number.isFinite(source.cacheAgeHours) || source.cacheAgeHours < 0 || source.cacheAgeHours > 168))
+            throw Error('Invalid UST cache age');
+        if (source.status === 'live' && source.cacheAgeHours !== undefined)
+            throw Error('Live UST source cannot claim cache age');
+        const parsed = parseUstXml(source.raw, source.month);
+        omittedIncompleteDates += [...source.raw.matchAll(/<entry>/g)].length - parsed.length;
+        rows.push(...parsed);
+    }
+    const point = (requested) => {
+        const row = rows.filter(r => r.date <= requested).at(-1) ?? null;
+        const lag = row ? days(requested, row.date) : null;
+        const reason = !row ? 'UST 공통 관측일 없음' : lag > packet.maxLag ? `UST 관측일 ${lag}일 지연: 허용 ${packet.maxLag}일 초과` : null;
+        return { requested, actual: row?.date ?? null, lag, yields: reason ? null : row.yields, reason };
+    };
+    const current = point(packet.asOf), previous = point(packet.base);
+    const comparable = current.yields && previous.yields && current.actual !== previous.actual;
+    const changes = comparable ? Object.fromEntries(TENORS.map(t => [t, bp(current.yields[t], previous.yields[t])])) : null;
+    const spreads = Object.fromEntries([['5Y-3Y', 5, 3], ['10Y-5Y', 10, 5], ['10Y-3Y', 10, 3], ['30Y-10Y', 30, 10]].map(([name, longer, shorter]) => [name, current.yields ? bp(current.yields[longer], current.yields[shorter]) : null]));
+    const notes = [current.reason, previous.reason, ...(current.actual === previous.actual && current.actual ? ['두 기준일이 같은 UST 관측일로 정렬되어 변화 계산을 차단했습니다.'] : []), ...(omittedIncompleteDates ? [`UST 만기 결측이 있는 ${omittedIncompleteDates}개 관측일을 제외했습니다.`] : []), ...packet.sources.filter(s => s.status === 'cache').map(s => `${s.month}: 검증된 UST 캐시 사용`), ...packet.sources.filter(s => s.status === 'failed').map(s => `${s.month}: UST 원천 수집 실패 (${s.error})`)].filter((x) => !!x);
+    return { status: changes ? 'READY' : current.yields || previous.yields ? 'INCOMPLETE' : 'BLOCKED', current, previous, changes, spreads, movement: changes ? classify(changes[3], changes[10]) : '판정 불가', notes, rows };
+}

package/skills/government-bond-analysis/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "government-bond-analysis",
+  "description": "한국·미국 국채시장을 공식 금리 데이터로 분석하고 커브 변화, 한·미 금리차, 확인된 국채 입찰·통화정책 일정을 같은 형식으로 정리한다. 국고채·미국 국채 금리 비교, 최근 변화, 주요 일정 또는 출처 있는 보고서를 요청할 때 사용한다. 실시간 호가, 개별 채권 가격평가, 매매 추천은 다루지 않는다.",
+  "profiles": [
+    "lookup"
+  ],
+  "frontmatter": "name: government-bond-analysis\ndescription: 한국·미국 국채시장을 공식 금리 데이터로 분석하고 커브 변화, 한·미 금리차, 확인된 국채 입찰·통화정책 일정을 같은 형식으로 정리한다. 국고채·미국 국채 금리 비교, 최근 변화, 주요 일정 또는 출처 있는 보고서를 요청할 때 사용한다. 실시간 호가, 개별 채권 가격평가, 매매 추천은 다루지 않는다.\nlicense: MIT\nmetadata:\n  category: finance\n  locale: ko-KR\n  phase: v1"
+}