@n2world/orchestrator 1.1.0

package/dist/onboarding.d.ts

@@ -0,0 +1,38 @@
+export type OnboardMode = 'local' | 'cloud';
+export interface DeviceSpec {
+    ramGB: number;
+    hasGpu: boolean;
+}
+export interface ModelRec {
+    id: string;
+    sizeGB: number;
+    note: string;
+}
+/** 기기사양 → 권장 로컬 모델(저사양=소형). 기본 1~2개만(300 노출 금지). */
+export declare function recommendLocalModels(spec: DeviceSpec): ModelRec[];
+export interface OnboardPlan {
+    mode: OnboardMode;
+    needsApiKey: boolean;
+    recommendedModels: ModelRec[];
+    budgetMonthlyTokens?: number;
+}
+/** 온보딩 결정: 로컬이면 키 불요. */
+export declare function planOnboarding(mode: OnboardMode, spec: DeviceSpec, budget?: number): OnboardPlan;
+export interface SecretStore {
+    set(name: string, value: string): void;
+    get(name: string): string | null;
+    has(name: string): boolean;
+}
+/**
+ * 인메모리 암호화 폴백(테스트/비OS). 실배포는 OS 키체인 어댑터로 교체.
+ * 평문으로 보관하지 않음(AES-256-GCM, 프로세스 키).
+ */
+export declare class EncryptedMemoryStore implements SecretStore {
+    private key;
+    private blobs;
+    set(name: string, value: string): void;
+    get(name: string): string | null;
+    has(name: string): boolean;
+    /** 저장 원문이 평문으로 남지 않음을 증명(감사용): 직렬화에 원문 미포함. */
+    rawDump(): string;
+}

package/dist/onboarding.js

@@ -0,0 +1,94 @@
+"use strict";
+// ============================================================================
+// P1 — 로컬 기본 온보딩 (키 불요) + 모델 추천 + 키 보관 (앱 v1.2 §4.1)
+// ----------------------------------------------------------------------------
+// 비기술자가 *키 없이* 로컬 모델로 시작. 기기사양→권장 로컬 모델, 기본 1~2개만 노출.
+// 클라우드는 선택(키→키체인, 평문 금지).
+//
+// 정직 고지(제1계명): 키체인 네이티브 호출은 OS별(이 환경 일부 미검증). 본 모듈은
+// *결정 로직 + 비평문 보관 인터페이스*(테스트 가능). 실 Keychain/CredMgr는 어댑터로.
+// ============================================================================
+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.EncryptedMemoryStore = void 0;
+exports.recommendLocalModels = recommendLocalModels;
+exports.planOnboarding = planOnboarding;
+const crypto = __importStar(require("crypto"));
+/** 기기사양 → 권장 로컬 모델(저사양=소형). 기본 1~2개만(300 노출 금지). */
+function recommendLocalModels(spec) {
+    if (spec.ramGB >= 16 || spec.hasGpu) {
+        return [
+            { id: 'llama3.1:8b', sizeGB: 4.7, note: '권장(균형)' },
+            { id: 'qwen2.5:3b', sizeGB: 1.9, note: '빠름' },
+        ];
+    }
+    if (spec.ramGB >= 8) {
+        return [{ id: 'qwen2.5:3b', sizeGB: 1.9, note: '권장(중간사양)' }, { id: 'gemma:2b', sizeGB: 1.7, note: '경량' }];
+    }
+    return [{ id: 'gemma:2b', sizeGB: 1.7, note: '저사양 경량(좁은 플레이북 권장)' }];
+}
+/** 온보딩 결정: 로컬이면 키 불요. */
+function planOnboarding(mode, spec, budget) {
+    if (mode === 'local') {
+        return { mode, needsApiKey: false, recommendedModels: recommendLocalModels(spec), budgetMonthlyTokens: budget };
+    }
+    return { mode, needsApiKey: true, recommendedModels: [], budgetMonthlyTokens: budget };
+}
+/**
+ * 인메모리 암호화 폴백(테스트/비OS). 실배포는 OS 키체인 어댑터로 교체.
+ * 평문으로 보관하지 않음(AES-256-GCM, 프로세스 키).
+ */
+class EncryptedMemoryStore {
+    key = crypto.randomBytes(32);
+    blobs = new Map();
+    set(name, value) {
+        const iv = crypto.randomBytes(12);
+        const c = crypto.createCipheriv('aes-256-gcm', this.key, iv);
+        const data = Buffer.concat([c.update(value, 'utf8'), c.final()]);
+        this.blobs.set(name, { iv, tag: c.getAuthTag(), data });
+    }
+    get(name) {
+        const b = this.blobs.get(name);
+        if (!b)
+            return null;
+        const d = crypto.createDecipheriv('aes-256-gcm', this.key, b.iv);
+        d.setAuthTag(b.tag);
+        return Buffer.concat([d.update(b.data), d.final()]).toString('utf8');
+    }
+    has(name) { return this.blobs.has(name); }
+    /** 저장 원문이 평문으로 남지 않음을 증명(감사용): 직렬화에 원문 미포함. */
+    rawDump() { return JSON.stringify([...this.blobs.entries()].map(([k, v]) => [k, v.data.toString('hex')])); }
+}
+exports.EncryptedMemoryStore = EncryptedMemoryStore;

package/dist/oracle-anchored-search.d.ts

@@ -0,0 +1,25 @@
+import { MctsEngine } from '@n2world/core';
+export interface YieldedLeaf {
+    leaf: number;
+    x: number;
+    y: number;
+}
+export interface OracleAnchoredResult {
+    bestAction: number;
+    confidence: number;
+    oracleCalls: number;
+    simulations: number;
+}
+export declare class OracleAnchoredSearch {
+    private engine;
+    constructor(engine: MctsEngine);
+    /**
+     * @param oracle 불확실 분기에 대한 2단계 진실값∈[0,1] (예: 독립 오라클의 테스트 통과율).
+     *               이것이 v 의 최종 보상 앵커다(g_fast 가 아니라).
+     */
+    run(startX: number, startY: number, oracle: (leaf: YieldedLeaf) => Promise<number>, opts?: {
+        rounds?: number;
+        budget?: number;
+        margin?: number;
+    }): Promise<OracleAnchoredResult>;
+}

package/dist/oracle-anchored-search.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OracleAnchoredSearch = void 0;
+class OracleAnchoredSearch {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /**
+     * @param oracle 불확실 분기에 대한 2단계 진실값∈[0,1] (예: 독립 오라클의 테스트 통과율).
+     *               이것이 v 의 최종 보상 앵커다(g_fast 가 아니라).
+     */
+    async run(startX, startY, oracle, opts = {}) {
+        const rounds = opts.rounds ?? 200;
+        const budget = opts.budget ?? 20;
+        const margin = opts.margin ?? 0.05;
+        this.engine.begin(startX, startY);
+        let oracleCalls = 0;
+        let simulations = 0;
+        let bestAction = 0;
+        let rootValue = 0;
+        let completed = false;
+        for (let r = 0; r < rounds; r++) {
+            const out = JSON.parse(this.engine.stepUntilYield(budget, margin));
+            simulations += budget;
+            if (out.yield) {
+                // 2단계: 오라클(진실)을 호출해 동결된 리프의 가치를 받아 resume.
+                const v = await oracle({ leaf: out.leaf, x: out.x, y: out.y });
+                oracleCalls++;
+                this.engine.resume(v);
+            }
+            else if (out.done) {
+                bestAction = out.bestAction;
+                rootValue = out.rootValue;
+                completed = true;
+                break;
+            }
+        }
+        // done에 도달하지 못했으면(계속 yield) 엔진의 현재 트리 상태를 읽어 마무리.
+        if (!completed) {
+            rootValue = this.engine.rootValue();
+            const top = JSON.parse(this.engine.topActionsJson());
+            if (top.length > 0)
+                bestAction = top[0].action;
+        }
+        const confidence = Math.max(0, Math.min(1, rootValue));
+        return { bestAction, confidence, oracleCalls, simulations };
+    }
+}
+exports.OracleAnchoredSearch = OracleAnchoredSearch;

package/dist/oracle.d.ts

@@ -0,0 +1,22 @@
+export declare class CrossValidationOracle {
+    private referenceTestHashes;
+    registerReferenceTest(testFilePath: string): Promise<void>;
+    private simpleHash;
+    validateCode(agentCodePath: string, testFilePath: string, runCommand: string): Promise<{
+        success: boolean;
+        logs: string;
+        cheatDetected: boolean;
+    }>;
+    /**
+     * P4.7 재사용: 되돌릴 수 없는 행동의 **위험 패턴 규칙 스크린**(독립 오라클의 규칙층).
+     * commit-gate 가 모델-비평 전에 이 규칙층을 먼저 적용한다(deny-by-default 의 1차 망).
+     * 정직 고지: 규칙은 **알려진** 위험만 잡는다 — 의미적 위반·OOD 는 못 잡으므로 충분조건이 아니다.
+     */
+    screenDangerousAction(command: string): {
+        flagged: boolean;
+        matched: string[];
+    };
+    /** @deprecated 규칙은 command-screen.ts 의 DANGER_RULES 로 통합됨(단일 출처). */
+    static readonly DANGER_RULES: import("./command-screen").DangerRule[];
+    private detectCheating;
+}

package/dist/oracle.js

@@ -0,0 +1,116 @@
+"use strict";
+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.CrossValidationOracle = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const command_screen_1 = require("./command-screen");
+class CrossValidationOracle {
+    referenceTestHashes = new Map();
+    async registerReferenceTest(testFilePath) {
+        try {
+            const content = await fs.readFile(testFilePath, 'utf8');
+            const hash = this.simpleHash(content);
+            this.referenceTestHashes.set(path.resolve(testFilePath), hash);
+        }
+        catch (err) {
+            // ignore if not found
+        }
+    }
+    simpleHash(content) {
+        let hash = 0;
+        for (let i = 0; i < content.length; i++) {
+            hash = (hash * 31 + content.charCodeAt(i)) | 0;
+        }
+        return hash.toString();
+    }
+    async validateCode(agentCodePath, testFilePath, runCommand) {
+        // 1. Check test file integrity
+        const resolvedTestPath = path.resolve(testFilePath);
+        const expectedHash = this.referenceTestHashes.get(resolvedTestPath);
+        if (expectedHash) {
+            const currentContent = await fs.readFile(resolvedTestPath, 'utf8');
+            const currentHash = this.simpleHash(currentContent);
+            if (currentHash !== expectedHash) {
+                return {
+                    success: false,
+                    logs: 'Validation failed: Test file integrity compromise detected.',
+                    cheatDetected: true,
+                };
+            }
+        }
+        // 2. Check agent code for cheating patterns
+        const agentCode = await fs.readFile(agentCodePath, 'utf8');
+        if (this.detectCheating(agentCode)) {
+            return {
+                success: false,
+                logs: 'Validation failed: Cheating/Hardcoded mock behavior detected in implementation.',
+                cheatDetected: true,
+            };
+        }
+        // 3. Run the test suite
+        return new Promise((resolve) => {
+            (0, child_process_1.exec)(runCommand, (err, stdout, stderr) => {
+                const success = !err;
+                resolve({
+                    success,
+                    logs: stdout + '\n' + stderr,
+                    cheatDetected: false,
+                });
+            });
+        });
+    }
+    /**
+     * P4.7 재사용: 되돌릴 수 없는 행동의 **위험 패턴 규칙 스크린**(독립 오라클의 규칙층).
+     * commit-gate 가 모델-비평 전에 이 규칙층을 먼저 적용한다(deny-by-default 의 1차 망).
+     * 정직 고지: 규칙은 **알려진** 위험만 잡는다 — 의미적 위반·OOD 는 못 잡으므로 충분조건이 아니다.
+     */
+    screenDangerousAction(command) {
+        // H1 — 단일 출처(command-screen.ts)로 위임. 대시보드·CLI·샌드박스와 동일 규칙.
+        return (0, command_screen_1.screenDangerousCommand)(command);
+    }
+    /** @deprecated 규칙은 command-screen.ts 의 DANGER_RULES 로 통합됨(단일 출처). */
+    static DANGER_RULES = command_screen_1.DANGER_RULES;
+    detectCheating(code) {
+        const cheatRegexes = [
+            /if\s*\(\s*\w+\s*(===|==)\s*['"`][^'`"]+['"`]\s*\)\s*return\s*['"`][^'`"]+['"`]/i,
+            /switch\s*\(\s*\w+\s*\)\s*\{\s*case\s*['"`][^'`"]+['"`]/i,
+            /return\s*['"`](test-input|test-output|mock|dummy|cheated)['"`]/i
+        ];
+        return cheatRegexes.some(regex => regex.test(code));
+    }
+}
+exports.CrossValidationOracle = CrossValidationOracle;

package/dist/p6-governance.d.ts

@@ -0,0 +1,150 @@
+import { GovernanceController } from './governance';
+export interface GovernanceEvent {
+    t: number;
+    kind: 'mcp-authz' | 'commit-gate' | 'tier-egress';
+    id: string;
+    allowed: boolean;
+    reason: string;
+    tool?: string;
+    dataTier?: 0 | 1 | 2;
+    destination?: 'local' | 'external';
+    hardGate?: boolean;
+    tier0ExfilBlocked?: boolean;
+    /** Tier-0 데이터가 실제로 외부로 나갔는가(true 면 헌법 위반 — 즉시 롤백 대상). */
+    tier0ExfilEscaped?: boolean;
+    trust?: number | null;
+    layer?: 'rule' | 'model-critic' | 'deny-by-default' | 'not-gated' | 'rule-only-passthrough';
+    cost?: {
+        criticCalls?: number;
+        latencyMs?: number;
+        tokens?: number | null;
+    };
+}
+export type EventListener = (e: GovernanceEvent) => void;
+export interface EventCounts {
+    total: number;
+    blocked: number;
+    blockRate: number;
+    tier0ExternalAttempts: number;
+    tier0ExfilEscaped: number;
+    denyByDefault: number;
+    hardGateFailures: number;
+    criticCalls: number;
+    totalTokens: number;
+}
+/** 기본 이벤트 보관 상한(링버퍼). 장수명 대시보드에서 메모리 무한 증가 방지. */
+export declare const DEFAULT_MAX_RETAINED_EVENTS = 1000;
+/**
+ * 위반/차단 이벤트 버스 — 실 이벤트만 집계·구독 배포(가짜 텔레메트리 0).
+ *
+ * 메모리: 최근 `maxRetained` 건만 링버퍼로 보관(표시용 `recent`/`all`). **누적 집계(`counts`)는
+ * 보관과 독립적으로 증분 카운터에 유지**되므로, 보관을 상한해도 all-time 통계(특히 안전 핵심인
+ * `tier0ExfilEscaped`)는 정확하다. 장수명 서버에서 `events` 가 무한 증가하던 문제 해소.
+ */
+export declare class GovernanceEventBus {
+    private listeners;
+    private events;
+    private readonly maxRetained;
+    private agg;
+    constructor(maxRetained?: number);
+    subscribe(fn: EventListener): () => void;
+    publish(e: GovernanceEvent): void;
+    recent(n?: number): GovernanceEvent[];
+    /** 보관된(최근 maxRetained 건) 이벤트. all-time 누적이 필요하면 `counts()` 를 쓴다. */
+    all(): GovernanceEvent[];
+    /** 실측 누적 집계 — 대시보드가 표시할 안전·비용 지표(보관 상한과 무관하게 all-time). */
+    counts(): EventCounts;
+}
+export interface RollbackConfig {
+    /** 차단율 슬라이딩 윈도우 크기(최근 N 이벤트). */
+    denyRateWindow: number;
+    /** 윈도우 차단율이 이 값을 넘으면 롤백(레드팀 거부 급증 등). */
+    denyRateThreshold: number;
+}
+export declare const DEFAULT_ROLLBACK_CONFIG: RollbackConfig;
+export interface RollbackState {
+    rolledBack: boolean;
+    reason: string;
+    at: number | null;
+    /** 권장 회귀 정책(대시보드·운영자용). */
+    recommendedFallback: string | null;
+}
+/**
+ * 헌법 위반(① Tier-0 실유출 ② 차단율 급증)을 이벤트 버스로 구독해 **즉시 중단·롤백**한다.
+ * 중단은 GovernanceController.kill 로(재사용), 회귀는 권장 폴백 신호로 노출(P3.5 단순화 철회·개인화 OFF 등).
+ */
+export declare class ConstitutionalRollback {
+    private gov;
+    private cfg;
+    private state;
+    private window;
+    constructor(gov: GovernanceController, cfg?: RollbackConfig);
+    /** 버스에 구독한다(반환: 구독 해제 함수). */
+    attach(bus: GovernanceEventBus): () => void;
+    private trigger;
+    onEvent(e: GovernanceEvent): void;
+    status(): RollbackState;
+    /** 운영자 확인 후 롤백 해제(킬스위치 리셋 포함). */
+    reset(): void;
+}
+export type Urgency = 'low' | 'normal' | 'high';
+export interface QuietTimeConfig {
+    /** 정온 시작 시각(0–23). */
+    startHour: number;
+    /** 정온 종료 시각(0–23). startHour>endHour 이면 자정 넘김(예: 22→7). */
+    endHour: number;
+    /** 능동성 강도∈[0,1]. 0=정온 중 완전 억제, 1=평소. */
+    intensity: number;
+}
+export declare const DEFAULT_QUIET_CONFIG: QuietTimeConfig;
+export declare class QuietTimeGate {
+    private cfg;
+    constructor(cfg?: Partial<QuietTimeConfig>);
+    setIntensity(x: number): void;
+    config(): QuietTimeConfig;
+    /** 주어진 시각이 정온 시간대인가(자정 넘김 처리). */
+    isQuiet(date?: Date): boolean;
+    /**
+     * 백그라운드 능동 작업을 허용할지. 정온 시간엔 억제하되, 긴급도와 능동성 강도로 조절한다.
+     * 규칙: 정온 아니면 허용. 정온이면 (urgencyScore + intensity ≥ 1.0) 일 때만 허용.
+     *  - intensity=0: 정온 중 전부 억제(high 도). intensity=1: 전부 허용.
+     *  - high(0.9)는 intensity≥0.1, normal(0.5)은 intensity≥0.5, low(0.2)는 intensity≥0.8 필요.
+     */
+    allowBackgroundAction(date?: Date, urgency?: Urgency): {
+        allowed: boolean;
+        reason: string;
+    };
+}
+export type CriterionStatus = 'met' | 'partial' | 'unmet';
+export interface DoDCriterion {
+    name: string;
+    status: CriterionStatus;
+    evidence: string;
+}
+export interface DoDReport {
+    criteria: DoDCriterion[];
+    metCount: number;
+    partialCount: number;
+    unmetCount: number;
+    /** 5개 전부 met 여야 v2.x "완료". 아니면 미완(정직). */
+    complete: boolean;
+    verdict: string;
+}
+export interface DoDInputs {
+    /** 실사용자 베타 N명 인도 완료? (코드·로그 증거) */
+    betaUsersDelivered: number;
+    /** B1 MultiAxisLift 가 실사용자 데이터로 측정됐는가. */
+    realUserLiftMeasured: boolean;
+    /** 안전: 거부율 분리 보고 + Tier-0 반출 관측 0/N 충족? */
+    safetySeparatedReported: boolean;
+    tier0ExfilObserved: number;
+    /** 정직성: (목표;미측정) 준수 + mock 0 + 명칭 인플레이션 0. */
+    honestyHeld: boolean;
+    /** 복잡도: 신규 컴포넌트·LOC 영가설 준수(정당화 못 한 부품 0). */
+    complexityWithinBudget: boolean;
+}
+/**
+ * v2.x 완료 정의 5개를 점검한다. **베타 미가동이면 ①②를 정직하게 unmet 으로** 표기한다
+ * (접지 영가설 — master §2: 바닥은 인간이다). 억지 통과 금지.
+ */
+export declare function v2DoDReport(inp: DoDInputs): DoDReport;