@n2world/orchestrator 1.1.0

package/dist/tier-guard.d.ts

@@ -0,0 +1,36 @@
+import { Tier } from './tier-classifier';
+export type ProviderKind = 'local' | 'external';
+/** 제공자 id → kind. 미등록 제공자는 보수적으로 external 취급. */
+export declare function providerKind(provider: string): ProviderKind;
+export interface RouteRequest {
+    tier: Tier;
+    provider: string;
+    /** Tier-1 외부 송신 시 사용자 동의가 있었는가(과제별 명시 동의). */
+    userConsent?: boolean;
+}
+export interface RouteDecision {
+    allowed: boolean;
+    reason: string;
+    /** Tier-0인데 external 요청 시, 강제할 로컬 사용 권고. */
+    forceLocal?: boolean;
+}
+export interface EgressAuditEntry {
+    t: number;
+    tier: Tier;
+    provider: string;
+    kind: ProviderKind;
+    allowed: boolean;
+    reason: string;
+}
+/**
+ * TierGuard — LLM 호출 직전 라우팅 판정 + egress 감사.
+ * Tier-0 외부 송신은 *항상* 차단(allowed=false). 감사 로그로 `관측 0/N` 증명.
+ */
+export declare class TierGuard {
+    private audit;
+    evaluate(req: RouteRequest): RouteDecision;
+    /** 감사 로그 전체. */
+    auditLog(): EgressAuditEntry[];
+    /** Tier-0 데이터가 외부로 *허용된* 건수(반드시 0이어야 함). */
+    tier0ExternalAllowed(): number;
+}

package/dist/tier-guard.js

@@ -0,0 +1,56 @@
+"use strict";
+// ============================================================================
+// v2.5.2 Phase S — TierGuard (LLM 프롬프트 경로 egress 통제)
+// ----------------------------------------------------------------------------
+// 계획서 v2.5.2 §5: TierGuard는 샌드박스 egress뿐 아니라 **LLM 프롬프트 경로**에도
+// 적용된다. Tier-0 데이터의 외부 제공사 송신을 차단하고 로컬을 강제하며, 모든 시도를
+// 감사한다. Tier-0 외부 송신이 1건이라도 관측되면(allowed) 헌법 제4조 위반이다.
+//
+// 제공자 분류: anthropic/google/openrouter/... = external, ollama/mlx/local = local.
+// 정직 고지(제1계명): ZDR(무학습·무보존)은 계약일 뿐 기술 보장 아님. Tier-0는 *로컬만*.
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TierGuard = void 0;
+exports.providerKind = providerKind;
+/** 제공자 id → kind. 미등록 제공자는 보수적으로 external 취급. */
+function providerKind(provider) {
+    const p = provider.toLowerCase();
+    const local = ['local', 'ollama', 'mlx', 'llama.cpp', 'whisper-local'];
+    return local.some((l) => p.includes(l)) ? 'local' : 'external';
+}
+/**
+ * TierGuard — LLM 호출 직전 라우팅 판정 + egress 감사.
+ * Tier-0 외부 송신은 *항상* 차단(allowed=false). 감사 로그로 `관측 0/N` 증명.
+ */
+class TierGuard {
+    audit = [];
+    evaluate(req) {
+        const kind = providerKind(req.provider);
+        let decision;
+        if (req.tier === 0) {
+            decision = kind === 'local'
+                ? { allowed: true, reason: 'Tier-0 → 로컬 허용' }
+                : { allowed: false, reason: 'Tier-0 외부 송신 금지 → 로컬 강제', forceLocal: true };
+        }
+        else if (req.tier === 1) {
+            if (kind === 'local')
+                decision = { allowed: true, reason: 'Tier-1 → 로컬 우선 허용' };
+            else
+                decision = req.userConsent === true
+                    ? { allowed: true, reason: 'Tier-1 외부 송신 — 과제별 동의+로깅' }
+                    : { allowed: false, reason: 'Tier-1 외부 송신 동의 없음 → 차단(로컬 우선)', forceLocal: true };
+        }
+        else {
+            decision = { allowed: true, reason: 'Tier-2 → 허용' };
+        }
+        this.audit.push({ t: Date.now(), tier: req.tier, provider: req.provider, kind, allowed: decision.allowed, reason: decision.reason });
+        return decision;
+    }
+    /** 감사 로그 전체. */
+    auditLog() { return [...this.audit]; }
+    /** Tier-0 데이터가 외부로 *허용된* 건수(반드시 0이어야 함). */
+    tier0ExternalAllowed() {
+        return this.audit.filter((e) => e.tier === 0 && e.kind === 'external' && e.allowed).length;
+    }
+}
+exports.TierGuard = TierGuard;

package/dist/tui.d.ts

@@ -0,0 +1,9 @@
+/** 시각 폭 기준으로 오른쪽을 공백으로 채운다(CJK 더블폭 반영). 테스트용 export. */
+export declare function padVisual(s: string, width: number): string;
+/** 아주 가벼운 마크다운을 ANSI 로 변환한다(제목·불릿·인용·코드펜스·굵게·인라인코드). 테스트용 export. */
+export declare function formatMarkdown(text: string): string;
+/**
+ * Rich TUI 대화 세션. 영속/복원/도구 실행은 chat 과 동일(같은 chat-data/history.json).
+ * 플래그: --fresh(초기화), --export(마크다운 내보내고 종료).
+ */
+export declare function runRichTui(flags?: string[]): Promise<void>;

package/dist/tui.js

@@ -0,0 +1,214 @@
+"use strict";
+// ============================================================================
+// Rich TUI — 터미널 대화 인터페이스 (둥근 패널·컬러·CJK 인식 줄바꿈)
+// ----------------------------------------------------------------------------
+// CLI `chat`(plain REPL)의 풍부한 버전. blessed/ink 같은 무거운 프레임워크 없이
+// chalk + wrap-ansi(+string-width)로 패널형 UI를 그린다. 대화 영속/복원/도구 실행은
+// ChatStore + askAgentChat 를 그대로 재사용한다(웹/CLI 와 같은 chat-data/history.json).
+// ============================================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.padVisual = padVisual;
+exports.formatMarkdown = formatMarkdown;
+exports.runRichTui = runRichTui;
+const readline = __importStar(require("readline"));
+const chalk_1 = __importDefault(require("chalk"));
+const wrap_ansi_1 = __importDefault(require("wrap-ansi"));
+const string_width_1 = __importDefault(require("string-width"));
+const llm_1 = require("./llm");
+const chat_store_1 = require("./chat-store");
+const index_1 = require("./index");
+const ROUND = { tl: '╭', tr: '╮', bl: '╰', br: '╯', h: '─', v: '│' };
+function termWidth() {
+    return Math.max(40, Math.min(process.stdout.columns || 80, 110));
+}
+/** 시각 폭 기준으로 오른쪽을 공백으로 채운다(CJK 더블폭 반영). 테스트용 export. */
+function padVisual(s, width) {
+    const pad = width - (0, string_width_1.default)(s);
+    return pad > 0 ? s + ' '.repeat(pad) : s;
+}
+/** 아주 가벼운 마크다운을 ANSI 로 변환한다(제목·불릿·인용·코드펜스·굵게·인라인코드). 테스트용 export. */
+function formatMarkdown(text) {
+    const out = [];
+    let inCode = false;
+    for (const raw of (text || '').split('\n')) {
+        const line = raw.replace(/\r$/, '');
+        if (/^\s*```/.test(line)) {
+            inCode = !inCode;
+            out.push(chalk_1.default.dim('────'));
+            continue;
+        }
+        if (inCode) {
+            out.push(chalk_1.default.gray(line));
+            continue;
+        }
+        let m;
+        if ((m = line.match(/^(#{1,6})\s+(.*)$/))) {
+            out.push(chalk_1.default.bold.cyan(m[2]));
+            continue;
+        }
+        if ((m = line.match(/^\s*[-*]\s+(.*)$/))) {
+            out.push(chalk_1.default.green('  • ') + inline(m[1]));
+            continue;
+        }
+        if ((m = line.match(/^\s*\d+\.\s+(.*)$/))) {
+            out.push(chalk_1.default.green('  ' + line.trim().split('.')[0] + '. ') + inline(line.replace(/^\s*\d+\.\s+/, '')));
+            continue;
+        }
+        if (/^\s*>/.test(line)) {
+            out.push(chalk_1.default.dim('▎ ' + line.replace(/^\s*>\s?/, '')));
+            continue;
+        }
+        out.push(inline(line));
+    }
+    return out.join('\n');
+}
+/** 인라인: **굵게**, `코드`. */
+function inline(s) {
+    return s
+        .replace(/\*\*(.+?)\*\*/g, (_, t) => chalk_1.default.bold(t))
+        .replace(/`([^`]+)`/g, (_, t) => chalk_1.default.yellow(t));
+}
+/** 둥근 박스 패널을 그린다. CJK 폭을 반영해 테두리를 정렬. */
+function panel(role, body) {
+    const width = termWidth();
+    const inner = width - 4; // 좌우 테두리(│ ) + 우측 공백
+    const color = role === 'user' ? chalk_1.default.blueBright : role === 'assistant' ? chalk_1.default.greenBright : chalk_1.default.magentaBright;
+    const title = role === 'user' ? '🧑 You' : role === 'assistant' ? '🤖 Ethan' : 'ⓘ 시스템';
+    const empty = role === 'assistant' && !body.trim();
+    const formatted = empty ? chalk_1.default.dim('(이 턴은 응답이 없었습니다)') : formatMarkdown(body);
+    const wrapped = (0, wrap_ansi_1.default)(formatted, inner, { hard: true, trim: false });
+    const top = color(ROUND.tl + ROUND.h + ' ') + color.bold(title) + ' ' + color(ROUND.h.repeat(Math.max(0, width - 4 - (0, string_width_1.default)(title))) + ROUND.tr);
+    const bottom = color(ROUND.bl + ROUND.h.repeat(width - 2) + ROUND.br);
+    const lines = wrapped.split('\n').map((ln) => color(ROUND.v) + ' ' + padVisual(ln, inner) + ' ' + color(ROUND.v));
+    return [top, ...lines, bottom].join('\n');
+}
+function banner(provider, model, storePath, resumed) {
+    const width = termWidth();
+    const line = chalk_1.default.cyan(ROUND.h.repeat(width));
+    const t = chalk_1.default.bold.cyan('  n2world · Ethan  ') + chalk_1.default.dim('— Rich TUI 대화');
+    const meta = chalk_1.default.dim(`  제공자 ${provider}/${model} · 저장 ${storePath}` + (resumed ? ` · 이전 대화 ${resumed}턴 복원` : ''));
+    const help = chalk_1.default.dim('  입력 후 Enter 전송 · 명령: ') + chalk_1.default.yellow('/exit /fresh /export /help');
+    return [line, t, meta, help, line].join('\n');
+}
+/** 입력 직전, 응답 대기 표시(완료 시 그 줄을 지운다). */
+function thinkingLine() {
+    process.stdout.write(chalk_1.default.dim('  ⏳ Ethan 생각 중…\n'));
+}
+function eraseThinking() {
+    process.stdout.write('\x1b[1A\x1b[2K'); // 한 줄 위로 + 그 줄 삭제
+}
+/**
+ * Rich TUI 대화 세션. 영속/복원/도구 실행은 chat 과 동일(같은 chat-data/history.json).
+ * 플래그: --fresh(초기화), --export(마크다운 내보내고 종료).
+ */
+async function runRichTui(flags = []) {
+    const store = new chat_store_1.ChatStore();
+    store.load();
+    if (flags.includes('--export')) {
+        if (store.count() === 0)
+            return void console.log(chalk_1.default.dim(`저장된 대화가 없습니다(${store.path_()}).`));
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const outPath = path.join('chat-data', `export-${Date.now()}.md`);
+        await fs.mkdir('chat-data', { recursive: true });
+        await fs.writeFile(outPath, store.exportMarkdown(), 'utf8');
+        return void console.log(chalk_1.default.green(`대화 ${store.count()}턴을 내보냈습니다: ${outPath}`));
+    }
+    const info = (0, llm_1.activeLlmInfo)();
+    if (!info.provider) {
+        console.error(chalk_1.default.red('[알림] LLM API 키가 없습니다. 루트 .env 에 GEMINI_API_KEY 또는 ANTHROPIC_API_KEY 를 설정하세요(.env.example).'));
+        process.exit(1);
+    }
+    if (flags.includes('--fresh')) {
+        store.clear();
+    }
+    const sandbox = new index_1.LocalSandbox();
+    await sandbox.init();
+    const worker = new index_1.WorkerAgent(sandbox);
+    const runShell = async (cmd) => {
+        const res = await worker.executeTask(cmd);
+        return `[cmd: ${cmd}]\n${res.stdout}\n${res.stderr}`;
+    };
+    console.log(banner(info.provider, info.model || '', store.path_(), store.count()));
+    for (const t of store.history())
+        console.log(panel(t.role, t.content));
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const ask = () => new Promise((resolve) => rl.question(chalk_1.default.blueBright.bold('\nyou ▸ '), resolve));
+    for (;;) {
+        const raw = (await ask()).trim();
+        if (raw === '')
+            continue;
+        if (/^\/(exit|quit|bye)$/i.test(raw))
+            break;
+        if (/^\/help$/i.test(raw)) {
+            console.log(panel('system', '명령: **/exit** 종료 · **/fresh** 새 대화 · **/export** 마크다운 저장 · **/help** 도움말\n그 외 입력은 모두 Ethan에게 전송됩니다.'));
+            continue;
+        }
+        if (/^\/fresh$/i.test(raw)) {
+            store.clear();
+            console.log(panel('system', '이전 대화를 초기화했습니다(새 대화 시작).'));
+            continue;
+        }
+        if (/^\/export$/i.test(raw)) {
+            const fs = await import('fs/promises');
+            const path = await import('path');
+            const outPath = path.join('chat-data', `export-${Date.now()}.md`);
+            await fs.mkdir('chat-data', { recursive: true });
+            await fs.writeFile(outPath, store.exportMarkdown(), 'utf8');
+            console.log(panel('system', `대화 ${store.count()}턴을 내보냈습니다: ${outPath}`));
+            continue;
+        }
+        console.log(panel('user', raw));
+        store.append({ role: 'user', content: raw });
+        thinkingLine();
+        let reply;
+        try {
+            reply = await (0, llm_1.askAgentChat)(store.history(), runShell);
+        }
+        catch (e) {
+            reply = `[오류] ${e?.message ?? e}`;
+        }
+        eraseThinking();
+        store.append({ role: 'assistant', content: reply });
+        console.log(panel('assistant', reply));
+    }
+    rl.close();
+    await sandbox.destroy();
+    console.log(chalk_1.default.dim(`\n대화를 종료합니다. (${store.count()}턴 저장됨: ${store.path_()})`));
+}

package/dist/update-security.d.ts

@@ -0,0 +1,31 @@
+export interface ReleaseMeta {
+    version: string;
+    sha256: string;
+    signature: string;
+}
+export interface VerifyResult {
+    ok: boolean;
+    reason: string;
+}
+/** semver 단순 비교(major.minor.patch). a>b → 1. */
+export declare function cmpVersion(a: string, b: string): number;
+/** 서명 검증용 HMAC(대칭) — 데모. 실배포는 Ed25519 공개키 권장(아래 verifyEd25519). */
+export declare function signMeta(version: string, sha256: string, secret: string): string;
+/**
+ * 다운로드 검증: 콘텐츠 해시 + 서명 + 다운그레이드 거부.
+ * @param content 다운로드한 바이너리(Buffer)
+ * @param meta 신뢰 채널에서 받은 릴리스 메타
+ * @param trust 검증 자료(HMAC secret 또는 Ed25519 공개키)
+ * @param currentVersion 설치된 현재 버전(없으면 '0.0.0')
+ */
+export declare function verifyDownload(content: Buffer, meta: ReleaseMeta, trust: {
+    hmacSecret?: string;
+    ed25519PublicKeyPem?: string;
+    requireAsymmetric?: boolean;
+}, currentVersion?: string): VerifyResult;
+/** 업데이트 실패 시 직전 양호 버전으로 롤백 결정. */
+export declare function rollbackDecision(failed: VerifyResult, lastGood?: string): {
+    rollback: boolean;
+    to?: string;
+    reason: string;
+};

package/dist/update-security.js

@@ -0,0 +1,112 @@
+"use strict";
+// ============================================================================
+// P0 — 공급망 보안: Core 바이너리 서명검증 + TUF식 메타 + 롤백 (앱 v1.2 §4.1)
+// ----------------------------------------------------------------------------
+// "curl|bash식 해시만" 금지. 다운로드 바이너리는 (a) 콘텐츠 해시 일치 (b) 신뢰키
+// 서명 검증 (c) 다운그레이드(구버전) 거부 를 모두 통과해야 설치된다.
+//
+// 정직 고지(제1계명): 본 모듈은 *검증 로직*(테스트 가능)이다. 실제 macOS 공증·Windows
+// Authenticode 서명은 인증서·OS 도구 필요(이 환경 미수행 — 패키징 단계 별도 검증).
+// ============================================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmpVersion = cmpVersion;
+exports.signMeta = signMeta;
+exports.verifyDownload = verifyDownload;
+exports.rollbackDecision = rollbackDecision;
+const crypto = __importStar(require("crypto"));
+/** semver 단순 비교(major.minor.patch). a>b → 1. */
+function cmpVersion(a, b) {
+    const pa = a.split('.').map((n) => parseInt(n, 10) || 0);
+    const pb = b.split('.').map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) !== (pb[i] || 0))
+            return (pa[i] || 0) > (pb[i] || 0) ? 1 : -1;
+    }
+    return 0;
+}
+/** 서명 검증용 HMAC(대칭) — 데모. 실배포는 Ed25519 공개키 권장(아래 verifyEd25519). */
+function signMeta(version, sha256, secret) {
+    return crypto.createHmac('sha256', secret).update(`${version}:${sha256}`).digest('base64');
+}
+/**
+ * 다운로드 검증: 콘텐츠 해시 + 서명 + 다운그레이드 거부.
+ * @param content 다운로드한 바이너리(Buffer)
+ * @param meta 신뢰 채널에서 받은 릴리스 메타
+ * @param trust 검증 자료(HMAC secret 또는 Ed25519 공개키)
+ * @param currentVersion 설치된 현재 버전(없으면 '0.0.0')
+ */
+function verifyDownload(content, meta, trust, currentVersion = '0.0.0') {
+    // M1 — 운영 배포는 대칭키(HMAC) 금지. 클라이언트에 비밀을 임베드하면 추출→위조가 가능하므로
+    // Ed25519 공개키 검증을 강제한다. 명시 옵션 또는 NODE_ENV=production / 환경변수로 활성화.
+    const requireAsym = trust.requireAsymmetric
+        || process.env.NODE_ENV === 'production'
+        || /^(1|true|on)$/i.test(process.env.N2WORLD_UPDATE_REQUIRE_ED25519 || '');
+    if (requireAsym && !trust.ed25519PublicKeyPem) {
+        return { ok: false, reason: '운영 배포는 대칭키(HMAC) 금지 — Ed25519 공개키 검증 필요' };
+    }
+    // (a) 콘텐츠 해시
+    const actual = crypto.createHash('sha256').update(content).digest('hex');
+    if (actual !== meta.sha256)
+        return { ok: false, reason: `해시 불일치(${actual.slice(0, 8)}≠${meta.sha256.slice(0, 8)})` };
+    // (b) 서명 — Ed25519 우선(둘 다 주어지면 비대칭 우선).
+    let sigOk = false;
+    if (trust.ed25519PublicKeyPem) {
+        try {
+            sigOk = crypto.verify(null, Buffer.from(`${meta.version}:${meta.sha256}`), trust.ed25519PublicKeyPem, Buffer.from(meta.signature, 'base64'));
+        }
+        catch {
+            sigOk = false;
+        }
+    }
+    else if (trust.hmacSecret) {
+        const expected = signMeta(meta.version, meta.sha256, trust.hmacSecret);
+        sigOk = expected.length === meta.signature.length && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(meta.signature));
+    }
+    if (!sigOk)
+        return { ok: false, reason: '서명 검증 실패(신뢰키 불일치)' };
+    // (c) 다운그레이드 거부(롤백 공격 차단)
+    if (cmpVersion(meta.version, currentVersion) < 0)
+        return { ok: false, reason: `다운그레이드 거부(${meta.version} < ${currentVersion})` };
+    return { ok: true, reason: 'ok' };
+}
+/** 업데이트 실패 시 직전 양호 버전으로 롤백 결정. */
+function rollbackDecision(failed, lastGood) {
+    if (failed.ok)
+        return { rollback: false, reason: '검증 통과 — 롤백 불요' };
+    if (!lastGood)
+        return { rollback: false, reason: '롤백 대상 없음 — 설치 중단' };
+    return { rollback: true, to: lastGood, reason: `검증 실패(${failed.reason}) → ${lastGood} 롤백` };
+}

package/dist/v-calibration.d.ts

@@ -0,0 +1,16 @@
+export interface CalibSample {
+    /** 모델이 예측한 가치 v ∈ [0,1]. */
+    predicted: number;
+    /** 실제 성공 여부(독립 오라클 통과=1, 실패=0). */
+    outcome: 0 | 1;
+}
+/**
+ * Expected Calibration Error — 신뢰도 구간별 (평균 예측 v) vs (실제 성공률) 괴리의
+ * 표본가중 평균. 0에 가까울수록 잘 캘리브레이션됨.
+ */
+export declare function expectedCalibrationError(samples: CalibSample[], bins?: number): number;
+/** ECE 합격 시에만 v 기반 위임 활성. 미달이면 균등 위임 회귀(영가설). */
+export declare function delegationEnabled(samples: CalibSample[], eceThreshold?: number): {
+    enabled: boolean;
+    ece: number;
+};

package/dist/v-calibration.js

@@ -0,0 +1,42 @@
+"use strict";
+// ============================================================================
+// v2.5.2 Phase 2 — 가치 v 캘리브레이션 (ECE) — 위임의 전제
+// ----------------------------------------------------------------------------
+// 계획서 v2.5.2 §6: "v 낮은 서브태스크 로컬 위임"은 *v가 캘리브레이션됐을 때만* 유효.
+// 쓰레기 v → 잘못된 위임. ECE(Expected Calibration Error)를 측정해 합격선 미달 시
+// 위임을 비활성(균등 위임으로 회귀)한다.
+//
+// 정직 고지(제1계명): ECE는 (예측 v, 실제 성공 0/1) 쌍으로 측정한다(자가 채점 아님 —
+// 실제 결과는 독립 오라클 통과 여부).
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectedCalibrationError = expectedCalibrationError;
+exports.delegationEnabled = delegationEnabled;
+/**
+ * Expected Calibration Error — 신뢰도 구간별 (평균 예측 v) vs (실제 성공률) 괴리의
+ * 표본가중 평균. 0에 가까울수록 잘 캘리브레이션됨.
+ */
+function expectedCalibrationError(samples, bins = 10) {
+    if (samples.length === 0)
+        return 1; // 표본 없음 = 미검증(보수적 최악)
+    const buckets = Array.from({ length: bins }, () => []);
+    for (const s of samples) {
+        const p = Math.max(0, Math.min(1, s.predicted));
+        const idx = Math.min(bins - 1, Math.floor(p * bins));
+        buckets[idx].push(s);
+    }
+    let ece = 0;
+    for (const b of buckets) {
+        if (b.length === 0)
+            continue;
+        const conf = b.reduce((a, s) => a + s.predicted, 0) / b.length;
+        const acc = b.reduce((a, s) => a + s.outcome, 0) / b.length;
+        ece += (b.length / samples.length) * Math.abs(conf - acc);
+    }
+    return ece;
+}
+/** ECE 합격 시에만 v 기반 위임 활성. 미달이면 균등 위임 회귀(영가설). */
+function delegationEnabled(samples, eceThreshold = 0.1) {
+    const ece = expectedCalibrationError(samples);
+    return { enabled: ece <= eceThreshold, ece };
+}

package/dist/value-calibration.d.ts

@@ -0,0 +1,41 @@
+/** 배열을 [pLow, pHigh] 분위수로 윈저라이즈(이상치 클리핑). */
+export declare function winsorize(values: number[], pLow?: number, pHigh?: number): number[];
+/** 루트 자식 Q들을 min-max 정규화 → v_norm∈[0,1]. */
+export declare function normalize(q: number, qMin: number, qMax: number): number;
+export interface AuditEntry {
+    source: string;
+    raw: number;
+    calibrated: number;
+    penalty: number;
+    t: number;
+}
+export declare class ValueCalibrator {
+    private minObservations;
+    private history;
+    private auditLog;
+    private killed;
+    constructor(minObservations?: number);
+    /** 적대적 팽창 관측 기록: 소스가 주장한 v 와 오라클이 매긴 실제 결과를 비교용으로 저장. */
+    observe(source: string, claimedV: number, actualOutcome: number): void;
+    /** 소스의 과거 과대평가 정도 → 감쇠 계수∈[0.1,1]. 부풀릴수록 1에서 멀어진다. */
+    inflationPenalty(source: string): number;
+    /**
+     * 소비 직전 보정: 정규화된 v_norm 에 팽창 감쇠를 적용하고 감사 로그에 남긴다.
+     * 킬스위치가 내려가 있으면 0(자원 차단)을 반환한다.
+     */
+    calibrate(source: string, vNorm: number): number;
+    /** v 와 오라클 실제 결과의 상관(영가설 판정용). |corr| 낮으면 v 스케줄링 근거 약함. */
+    correlationWithOracle(source: string): number;
+    getAuditLog(): AuditEntry[];
+    kill(): void;
+    reset(): void;
+    isKilled(): boolean;
+}
+/** 예산 상한 가드: 누적 토큰/비용이 상한을 넘으면 추가 소비를 차단. */
+export declare class BudgetGuard {
+    private cap;
+    private spent;
+    constructor(cap: number);
+    trySpend(amount: number): boolean;
+    remaining(): number;
+}