@wooojin/forgen 0.4.1 → 0.4.4

package/dist/services/session.js

@@ -10,6 +10,8 @@
  * - launch context(런타임 + 정제된 args)를 단일 타입으로 통일
  * - CLI/fgx에서 수집한 런타임 값을 Harness, Spawn, Hook Generator에 일관되게 전달
  */
+import { createRequire } from 'node:module';
+const localRequire = createRequire(import.meta.url);
 /** 런타임 정규화: 외부 문자열을 내부 enum으로 변환 */
 function parseRuntime(raw) {
     if (!raw)
@@ -24,17 +26,44 @@ function parseRuntime(raw) {
     }
 }
 const DEFAULT_RUNTIME = 'claude';
+/**
+ * profile.default_host 를 읽어 runtime 결정.
+ * 'ask' 면 별도 prompt 책임 — 본 함수는 default 'claude' 로 fallback (caller 가 --ask 처리).
+ * profile-store import 가 cycle 위험이라 require 로 lazy.
+ */
+function readProfileDefaultRuntime() {
+    try {
+        const mod = localRequire('../store/profile-store.js');
+        const stored = mod.getDefaultHost?.();
+        if (stored === 'claude' || stored === 'codex')
+            return stored;
+        return null; // 'ask' 또는 미설정
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * CLI 인자를 파싱해 런타임 결정 + 런타임 플래그 제거
- * - --runtime codex
- * - --runtime=codex
+ * 우선순위 (높음→낮음):
+ *   1. --runtime <claude|codex> flag
+ *   2. FORGEN_RUNTIME env
+ *   3. profile.default_host (P1-4)
+ *   4. 'claude' fallback (legacy 호환)
  */
 export function resolveLaunchContext(args) {
     const runtimeFromEnv = parseRuntime(process.env.FORGEN_RUNTIME);
+    const runtimeFromProfile = runtimeFromEnv ? null : readProfileDefaultRuntime();
+    const initial = runtimeFromEnv ?? runtimeFromProfile ?? DEFAULT_RUNTIME;
+    const initialSource = runtimeFromEnv
+        ? 'env'
+        : runtimeFromProfile
+            ? 'profile'
+            : 'default';
     const result = {
-        runtime: runtimeFromEnv ?? DEFAULT_RUNTIME,
+        runtime: initial,
         args: [],
-        runtimeSource: runtimeFromEnv ? 'env' : 'default',
+        runtimeSource: initialSource,
     };
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];

package/dist/store/compound-usage-store.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Forgen — compound usage signal store (Pathfinder D11 fix, MVP).
+ *
+ * 배경 (Deep Interview 2026-04-30 Round 5):
+ *   verified compound 23개, candidate 8개 — 그러나 mature 0. retro 회고에서
+ *   "활용률 측정 불가 — compound-search 호출 카운터 미수집" 확인. 즉 사용자가
+ *   compound 를 reuse 했다는 신호 자체가 잡히지 않아서 mature 승격 입력이 없음.
+ *
+ *   원칙(user-mirror, Round 4 Contrarian): forgen 자기 학습이 아니라 *사용자
+ *   reuse* 가 mature 의 권위 종착점. 따라서 compound-read 호출이 있을 때마다
+ *   "이 패턴이 사용됐다" 신호를 한 줄 기록.
+ *
+ * MVP 스코프: 신호 *수집*만. 승격 정책(예: 5회 reuse → mature) 은 다음 사이클.
+ *   기록만 잘 쌓이면 임계 설정·승격 로직은 위에 얹기 쉬움.
+ *
+ * 데이터: append-only JSONL at ~/.forgen/state/compound-usage.jsonl
+ *   각 라인: {"at": ISO, "name": "<solution-slug>", "via": "mcp|cli|hook"}
+ *   crash-safe: 단순 fs.appendFileSync — 동시 append 는 OS 가 atomic 보장 (POSIX <PIPE_BUF).
+ */
+export declare const COMPOUND_USAGE_LOG: string;
+export interface UsageEntry {
+    at: string;
+    name: string;
+    via: 'mcp' | 'cli' | 'hook';
+}
+export declare function recordUsage(name: string, via?: UsageEntry['via']): void;
+/** 단순 카운터 — 승격 정책에서 호출. MVP 에선 미사용. */
+export declare function readUsageCounts(): Map<string, number>;

package/dist/store/compound-usage-store.js

@@ -0,0 +1,59 @@
+/**
+ * Forgen — compound usage signal store (Pathfinder D11 fix, MVP).
+ *
+ * 배경 (Deep Interview 2026-04-30 Round 5):
+ *   verified compound 23개, candidate 8개 — 그러나 mature 0. retro 회고에서
+ *   "활용률 측정 불가 — compound-search 호출 카운터 미수집" 확인. 즉 사용자가
+ *   compound 를 reuse 했다는 신호 자체가 잡히지 않아서 mature 승격 입력이 없음.
+ *
+ *   원칙(user-mirror, Round 4 Contrarian): forgen 자기 학습이 아니라 *사용자
+ *   reuse* 가 mature 의 권위 종착점. 따라서 compound-read 호출이 있을 때마다
+ *   "이 패턴이 사용됐다" 신호를 한 줄 기록.
+ *
+ * MVP 스코프: 신호 *수집*만. 승격 정책(예: 5회 reuse → mature) 은 다음 사이클.
+ *   기록만 잘 쌓이면 임계 설정·승격 로직은 위에 얹기 쉬움.
+ *
+ * 데이터: append-only JSONL at ~/.forgen/state/compound-usage.jsonl
+ *   각 라인: {"at": ISO, "name": "<solution-slug>", "via": "mcp|cli|hook"}
+ *   crash-safe: 단순 fs.appendFileSync — 동시 append 는 OS 가 atomic 보장 (POSIX <PIPE_BUF).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { STATE_DIR } from '../core/paths.js';
+export const COMPOUND_USAGE_LOG = path.join(STATE_DIR, 'compound-usage.jsonl');
+export function recordUsage(name, via = 'mcp') {
+    if (!name)
+        return;
+    try {
+        fs.mkdirSync(STATE_DIR, { recursive: true });
+        const entry = { at: new Date().toISOString(), name, via };
+        fs.appendFileSync(COMPOUND_USAGE_LOG, JSON.stringify(entry) + '\n');
+    }
+    catch {
+        // fail-open: 신호 수집 실패가 사용자 경험을 방해하면 안 됨
+    }
+}
+/** 단순 카운터 — 승격 정책에서 호출. MVP 에선 미사용. */
+export function readUsageCounts() {
+    const counts = new Map();
+    if (!fs.existsSync(COMPOUND_USAGE_LOG))
+        return counts;
+    try {
+        const lines = fs.readFileSync(COMPOUND_USAGE_LOG, 'utf-8').split('\n').filter(Boolean);
+        for (const line of lines) {
+            try {
+                const entry = JSON.parse(line);
+                if (typeof entry.name === 'string') {
+                    counts.set(entry.name, (counts.get(entry.name) ?? 0) + 1);
+                }
+            }
+            catch {
+                // skip malformed
+            }
+        }
+    }
+    catch {
+        // fail-open
+    }
+    return counts;
+}

package/dist/store/evidence-store.d.ts

@@ -14,6 +14,7 @@ export declare function createEvidence(params: {
     candidate_rule_refs?: string[];
     confidence: number;
     raw_payload?: Record<string, unknown>;
+    host?: 'claude' | 'codex';
 }): Evidence;
 export declare function saveEvidence(evidence: Evidence): void;
 /**

package/dist/store/evidence-store.js

@@ -17,6 +17,24 @@ import { appendLifecycleEvents } from '../engine/lifecycle/meta-reclassifier.js'
 function evidencePath(evidenceId) {
     return path.join(ME_BEHAVIOR, `${evidenceId}.json`);
 }
+/**
+ * 현재 세션이 어느 host 에서 실행되는지 추론 (Multi-Host §4.2).
+ * 1) explicit `params.host`
+ * 2) env var `FORGEN_HOST` (e2e 격리용)
+ * 3) `runtime` env hint
+ * 4) Codex CLI 흔적 (`CODEX_HOME` 또는 `CODEX_SANDBOX_NETWORK_DISABLED`)
+ * 5) default 'claude' (1원칙)
+ */
+function detectHost(explicit) {
+    if (explicit)
+        return explicit;
+    const fromEnv = process.env.FORGEN_HOST;
+    if (fromEnv === 'claude' || fromEnv === 'codex')
+        return fromEnv;
+    if (process.env.CODEX_HOME || process.env.CODEX_SANDBOX_NETWORK_DISABLED)
+        return 'codex';
+    return 'claude';
+}
 export function createEvidence(params) {
     return {
         evidence_id: crypto.randomUUID(),
@@ -29,6 +47,7 @@ export function createEvidence(params) {
         candidate_rule_refs: params.candidate_rule_refs ?? [],
         confidence: params.confidence,
         raw_payload: params.raw_payload ?? {},
+        host: detectHost(params.host),
     };
 }
 /** TEST-4 / RC4: behavior_observation 의 summary 가 의미있는 내용을 담아야 분석 가능. */
@@ -84,8 +103,19 @@ export function appendEvidence(evidence) {
         return { saved: true, t1_events: 0 };
     }
 }
+/**
+ * 기존 evidence 에 host 필드가 없으면 'claude' 로 backfill (Multi-Host §4.2 마이그레이션 정책).
+ * 새 multi-host 도입 이전 데이터는 모두 Claude 에서 발생했음 — 이 backfill 은 무손실.
+ */
+function backfillHost(ev) {
+    if (!ev)
+        return ev;
+    if (ev.host === 'claude' || ev.host === 'codex')
+        return ev;
+    return { ...ev, host: 'claude' };
+}
 export function loadEvidence(evidenceId) {
-    return safeReadJSON(evidencePath(evidenceId), null);
+    return backfillHost(safeReadJSON(evidencePath(evidenceId), null));
 }
 export function loadAllEvidence() {
     if (!fs.existsSync(ME_BEHAVIOR))
@@ -95,8 +125,9 @@ export function loadAllEvidence() {
         if (!file.endsWith('.json'))
             continue;
         const ev = safeReadJSON(path.join(ME_BEHAVIOR, file), null);
-        if (ev)
-            items.push(ev);
+        const filled = backfillHost(ev);
+        if (filled)
+            items.push(filled);
     }
     return items;
 }

package/dist/store/host-mismatch.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Host-mismatch demote signal — Multi-Host Core Design §4.3 / §10 우선순위 5
+ *
+ * spec §12.2 / §18 결과: schema-level 등가성이 강하므로 *호스트별 가중치* 가 아니라
+ * *불일치 신호* 만 사용한다. 같은 솔루션/규칙이 한 host 에서만 자주 깨지면 그 host 한정으로
+ * demote 후보. 본 모듈은 그 신호를 *읽기만* 한다 — 실제 demote 적용은 lifecycle 트랙.
+ *
+ * 신호 정의 (Phase 1 단순 버전):
+ *   - solution_failed_to_apply_count_by_host
+ *   - block_acknowledged_then_revert_count_by_host
+ *   - drift_event_count_by_host
+ * 위 3 종 metric 을 evidence_id → host 매핑으로 집계.
+ */
+export type HostId = 'claude' | 'codex';
+export interface HostMismatchSummary {
+    readonly byHost: Record<HostId, number>;
+    readonly total: number;
+    /** ratio of host with most events to total (0..1). 0.5 = balanced, 1.0 = single-host signal. */
+    readonly skew: number;
+    /** the dominant host (or null if balanced). */
+    readonly dominantHost: HostId | null;
+    /** 본 신호가 lifecycle demote 를 권고할 정도로 강한지. 임계값은 1차 단순. */
+    readonly demoteRecommended: boolean;
+}
+/**
+ * 특정 솔루션/규칙 ID 에 대해 *부정적 evidence* (drift, revert, failure) 가 host 별로
+ * 어떻게 분포하는지 요약.
+ *
+ * 1차 구현은 evidence.summary 의 ID 매칭으로 단순 집계. 향후 evidence 가 명시적 ref 필드를
+ * 가지면 그쪽으로 전환.
+ */
+export declare function summarizeNegativeSignalsForRef(refId: string): HostMismatchSummary;
+export declare function summarizeAllByHost(): {
+    claude: number;
+    codex: number;
+    total: number;
+};
+/** 테스트 노출용 — 임계값이 변경되면 회귀 즉시 감지. */
+export declare const HOST_MISMATCH_TUNING: {
+    readonly DOMINANCE_THRESHOLD: 0.8;
+    readonly MIN_TOTAL_FOR_DEMOTE: 5;
+};

package/dist/store/host-mismatch.js

@@ -0,0 +1,65 @@
+/**
+ * Host-mismatch demote signal — Multi-Host Core Design §4.3 / §10 우선순위 5
+ *
+ * spec §12.2 / §18 결과: schema-level 등가성이 강하므로 *호스트별 가중치* 가 아니라
+ * *불일치 신호* 만 사용한다. 같은 솔루션/규칙이 한 host 에서만 자주 깨지면 그 host 한정으로
+ * demote 후보. 본 모듈은 그 신호를 *읽기만* 한다 — 실제 demote 적용은 lifecycle 트랙.
+ *
+ * 신호 정의 (Phase 1 단순 버전):
+ *   - solution_failed_to_apply_count_by_host
+ *   - block_acknowledged_then_revert_count_by_host
+ *   - drift_event_count_by_host
+ * 위 3 종 metric 을 evidence_id → host 매핑으로 집계.
+ */
+import { loadAllEvidence } from './evidence-store.js';
+const DOMINANCE_THRESHOLD = 0.8; // 80% 이상이 한 host 에서 발생하면 dominant.
+const MIN_TOTAL_FOR_DEMOTE = 5; // 너무 적은 표본은 무시.
+function summarize(events) {
+    const byHost = { claude: 0, codex: 0 };
+    for (const e of events) {
+        const h = (e.host ?? 'claude');
+        byHost[h] += 1;
+    }
+    const total = byHost.claude + byHost.codex;
+    if (total === 0) {
+        return { byHost, total, skew: 0, dominantHost: null, demoteRecommended: false };
+    }
+    const claudeShare = byHost.claude / total;
+    const codexShare = byHost.codex / total;
+    const dominant = claudeShare >= codexShare ? 'claude' : 'codex';
+    const skew = Math.max(claudeShare, codexShare);
+    const demoteRecommended = total >= MIN_TOTAL_FOR_DEMOTE && skew >= DOMINANCE_THRESHOLD;
+    return { byHost, total, skew, dominantHost: dominant, demoteRecommended };
+}
+/**
+ * 특정 솔루션/규칙 ID 에 대해 *부정적 evidence* (drift, revert, failure) 가 host 별로
+ * 어떻게 분포하는지 요약.
+ *
+ * 1차 구현은 evidence.summary 의 ID 매칭으로 단순 집계. 향후 evidence 가 명시적 ref 필드를
+ * 가지면 그쪽으로 전환.
+ */
+export function summarizeNegativeSignalsForRef(refId) {
+    const all = loadAllEvidence();
+    const matched = all.filter((e) => {
+        if (Array.isArray(e.candidate_rule_refs) && e.candidate_rule_refs.includes(refId))
+            return true;
+        if (typeof e.summary === 'string' && e.summary.includes(refId)) {
+            // 명시적 음수 키워드 (drift, revert, failed, block-revert) 가 있을 때만.
+            return /drift|revert|failed|regress/i.test(e.summary);
+        }
+        return false;
+    });
+    return summarize(matched);
+}
+export function summarizeAllByHost() {
+    const all = loadAllEvidence();
+    const r = { claude: 0, codex: 0 };
+    for (const e of all)
+        r[(e.host ?? 'claude')] += 1;
+    return { ...r, total: r.claude + r.codex };
+}
+/** 테스트 노출용 — 임계값이 변경되면 회귀 즉시 감지. */
+export const HOST_MISMATCH_TUNING = {
+    DOMINANCE_THRESHOLD,
+    MIN_TOTAL_FOR_DEMOTE,
+};

package/dist/store/profile-store.d.ts

@@ -19,3 +19,32 @@ export declare function saveProfile(profile: Profile): void;
  */
 export declare function profileExists(): boolean;
 export declare function isV1Profile(data: unknown): data is Profile;
+/**
+ * D2 fix (2026-04-27): explicit_correction 누적 시 해당 축의 confidence 를 점진
+ * 상승시킨다. facet 값은 건드리지 않음 (회귀 위험 최소화) — confidence 가 score
+ * 집계 공식 (confidence × facet_avg + (1-confidence) × neutral_anchor) 의 가중치
+ * 라서, 사용자가 명시 교정을 누적한 축은 score 가 facet 평균을 더 강하게 반영.
+ *
+ * 자기증거: autonomy explicit_correction 6건이 score 를 못 움직였음 (facet 값
+ * 갱신 경로가 mismatch-detector 의 strong rule 승급에만 의존). 본 함수가 직접
+ * 경로를 추가.
+ *
+ * delta 기본 0.02 — 6건 누적 시 +0.12 → 0.45 → 0.57 (의미 있는 변동 가시화).
+ * clamp 0~1.
+ */
+export declare function bumpAxisConfidence(axis: 'quality_safety' | 'autonomy' | 'judgment_philosophy' | 'communication_style', delta?: number): boolean;
+/**
+ * feat/codex-support — default_host 영속화 헬퍼.
+ *
+ * fgx / forgen 무인자 실행 시 어느 host 를 spawn 할지 결정. 'ask' 면 매번 묻기.
+ * 미설정(undefined) 은 legacy 사용자 호환 — 'claude' 로 resolve.
+ */
+export type DefaultHost = 'claude' | 'codex' | 'ask';
+export declare function getDefaultHost(): DefaultHost | undefined;
+export declare function setDefaultHost(host: DefaultHost): boolean;
+/**
+ * Resolve effective host for runtime use.
+ * 우선순위: explicit override > profile.default_host > 'claude' fallback.
+ * 'ask' 는 caller 가 별도 처리 (interactive prompt).
+ */
+export declare function resolveDefaultHost(override?: 'claude' | 'codex'): 'claude' | 'codex' | 'ask';

package/dist/store/profile-store.js

@@ -72,3 +72,56 @@ export function isV1Profile(data) {
     const p = data;
     return typeof p.model_version === 'string' && p.model_version.startsWith('2.');
 }
+/**
+ * D2 fix (2026-04-27): explicit_correction 누적 시 해당 축의 confidence 를 점진
+ * 상승시킨다. facet 값은 건드리지 않음 (회귀 위험 최소화) — confidence 가 score
+ * 집계 공식 (confidence × facet_avg + (1-confidence) × neutral_anchor) 의 가중치
+ * 라서, 사용자가 명시 교정을 누적한 축은 score 가 facet 평균을 더 강하게 반영.
+ *
+ * 자기증거: autonomy explicit_correction 6건이 score 를 못 움직였음 (facet 값
+ * 갱신 경로가 mismatch-detector 의 strong rule 승급에만 의존). 본 함수가 직접
+ * 경로를 추가.
+ *
+ * delta 기본 0.02 — 6건 누적 시 +0.12 → 0.45 → 0.57 (의미 있는 변동 가시화).
+ * clamp 0~1.
+ */
+export function bumpAxisConfidence(axis, delta = 0.02) {
+    const profile = loadProfile();
+    if (!profile)
+        return false;
+    const target = profile.axes[axis];
+    if (!target || typeof target.confidence !== 'number')
+        return false;
+    const next = Math.max(0, Math.min(1, target.confidence + delta));
+    if (next === target.confidence)
+        return false;
+    target.confidence = next;
+    saveProfile(profile);
+    return true;
+}
+export function getDefaultHost() {
+    const profile = loadProfile();
+    return profile?.default_host;
+}
+export function setDefaultHost(host) {
+    const profile = loadProfile();
+    if (!profile)
+        return false;
+    profile.default_host = host;
+    profile.metadata.updated_at = new Date().toISOString();
+    saveProfile(profile);
+    return true;
+}
+/**
+ * Resolve effective host for runtime use.
+ * 우선순위: explicit override > profile.default_host > 'claude' fallback.
+ * 'ask' 는 caller 가 별도 처리 (interactive prompt).
+ */
+export function resolveDefaultHost(override) {
+    if (override)
+        return override;
+    const stored = getDefaultHost();
+    if (stored === undefined)
+        return 'claude';
+    return stored;
+}

package/dist/store/types.d.ts

@@ -123,6 +123,12 @@ export interface Evidence {
     candidate_rule_refs: string[];
     confidence: number;
     raw_payload: Record<string, unknown>;
+    /**
+     * Multi-Host Core Design §4.2 / §10 우선순위 5.
+     * evidence 가 어느 host 에서 발생했는지 태그. 미지정 시 'claude' 로 backfill (기존 데이터 호환).
+     * core 의 학습 로직은 이 필드를 *호스트별 가중치* 가 아니라 *불일치 demote 신호* 로만 사용한다.
+     */
+    host?: 'claude' | 'codex';
 }
 export interface QualityFacets {
     verification_depth: number;
@@ -175,6 +181,13 @@ export interface Profile {
         last_onboarding_at: string;
         last_reclassification_at: string | null;
     };
+    /**
+     * feat/codex-support — 사용자가 fgx/forgen 무인자 실행 시 spawn 할 host.
+     *   - 'claude' / 'codex': 명시 default
+     *   - 'ask': 매번 묻기 (interactive prompt)
+     *   - undefined: legacy / 미설정 → 'claude' fallback (마이그레이션 호환)
+     */
+    default_host?: 'claude' | 'codex' | 'ask';
 }
 export type RecommendationSource = 'onboarding' | 'mismatch_recommendation';
 export type RecommendationStatus = 'proposed' | 'accepted' | 'archived';

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "Forgen harness hooks (auto-generated, 20/20 active)",
+  "description": "Forgen harness hooks (auto-generated, 21/21 active)",
   "hooks": {
     "UserPromptSubmit": [
       {
@@ -34,6 +34,11 @@
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/skill-injector.js\"",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/forge-loop-progress.js\"",
+            "timeout": 2
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooojin/forgen",
-  "version": "0.4.1",
+  "version": "0.4.4",
   "preferGlobal": true,
   "main": "dist/lib.js",
   "types": "./dist/lib.d.ts",
@@ -47,12 +47,15 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/wooo-jin/forgen.git"
+    "url": "https://github.com/forgen-team/forgen.git"
   },
   "engines": {
     "node": ">=20.0.0"
   },
   "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
   "bin": {
     "forgen": "./dist/cli.js",
     "fgx": "./dist/fgx.js",
@@ -60,8 +63,7 @@
   },
   "files": [
     "dist/",
-    "agents/",
-    "commands/",
+    "assets/",
     "skills/",
     "starter-pack/",
     "scripts/postinstall.js",

package/plugin.json

@@ -1,14 +1,14 @@
 {
   "$schema": "https://claude.ai/schemas/claude-plugin.json",
   "name": "forgen",
-  "version": "0.4.1",
+  "version": "0.4.4",
   "description": "Claude Code harness — the more you use Claude, the better it gets",
   "author": {
     "name": "jang-ujin",
     "url": "https://github.com/wooo-jin"
   },
-  "repository": "https://github.com/wooo-jin/forgen",
-  "homepage": "https://github.com/wooo-jin/forgen",
+  "repository": "https://github.com/forgen-team/forgen",
+  "homepage": "https://github.com/forgen-team/forgen",
   "license": "MIT",
   "keywords": [
     "claude-code",
@@ -17,7 +17,7 @@
     "forge"
   ],
   "skills": "./skills/",
-  "agents": "agents/",
+  "agents": "assets/claude/agents/",
   "statusLine": {
     "type": "command",
     "command": "forgen me"