@wooojin/forgen 0.4.1 → 0.4.3

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.3",
   "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.3",
   "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"

package/scripts/postinstall.js

@@ -89,7 +89,7 @@ function fixOwnership(...paths) {
 const HOME = resolveHome();
 
 // ── Paths ──
-const SKILLS_DIR = join(PKG_ROOT, 'commands');
+const SKILLS_DIR = join(PKG_ROOT, 'assets', 'claude', 'commands');
 const DIST_HOOKS = join(PKG_ROOT, 'dist', 'hooks');
 const COMMANDS_DIR = join(HOME, '.claude', 'commands', 'forgen');
 const CLAUDE_DIR = join(HOME, '.claude');
@@ -214,7 +214,7 @@ function registerPlugin() {
   if (!linked) {
     // 2차: 필수 디렉토리 복사
     mkdirSync(CACHE_DIR, { recursive: true });
-    const copyDirs = ['.claude-plugin', 'hooks', 'skills', 'commands', 'agents'];
+    const copyDirs = ['.claude-plugin', 'hooks', 'skills', 'assets'];
     for (const dir of copyDirs) {
       const src = join(PKG_ROOT, dir);
       if (existsSync(src)) {
@@ -330,7 +330,7 @@ function detectPluginConflicts() {
  * Claude Code 플러그인은 skills/{name}/SKILL.md 구조로 스킬을 인식.
  */
 function generateSkillsDir() {
-  const skillsSrc = join(PKG_ROOT, 'commands');
+  const skillsSrc = join(PKG_ROOT, 'assets', 'claude', 'commands');
   const skillsDst = join(PKG_ROOT, 'skills');
   if (!existsSync(skillsSrc)) return;
 
@@ -381,7 +381,7 @@ function generateSkillsDir() {
  */
 let HOOK_REGISTRY = [];
 try {
-  HOOK_REGISTRY = JSON.parse(readFileSync(join(PKG_ROOT, 'hooks', 'hook-registry.json'), 'utf-8'));
+  HOOK_REGISTRY = JSON.parse(readFileSync(join(PKG_ROOT, 'assets', 'shared', 'hook-registry.json'), 'utf-8'));
 } catch {
   console.warn('[forgen] hook-registry.json not found, skipping hook generation');
 }
@@ -738,6 +738,49 @@ function main() {
   migrateLegacyStorage();
   ensureDirectories();
 
+  // ── 0. 기존 forgen entry 감지 (마이그레이션 모드 분기) ──
+  //
+  // feat/codex-support (P1-6, 2026-04-27): postinstall 이 호스트 인젝션을 *자동*
+  // 으로 하던 v0.4.x 동작을 변경. 새로운 정책:
+  //   - 기존 사용자 (settings.json 에 forgen hook entry 있음): 그대로 갱신 (행동
+  //     변화 없음 — 마이그레이션 안전). default_host 자동 설정 안내 banner 출력.
+  //   - 신규 사용자 (forgen entry 없음): host 인젝션 자동 안 함. "Run `forgen
+  //     install`" banner 만 출력. 사용자가 어느 host (Claude/Codex/Both) 에 등록할지
+  //     명시 선택.
+  //
+  // 사용자 의도와 무관한 Claude bias (postinstall 이 ~/.claude/ 자동 인젝션) 제거.
+  let isExistingForgenUser = false;
+  if (existsSync(SETTINGS_PATH)) {
+    try {
+      const probe = JSON.parse(readFileSync(SETTINGS_PATH, 'utf-8'));
+      const hooks = probe?.hooks ?? {};
+      for (const arr of Object.values(hooks)) {
+        if (!Array.isArray(arr)) continue;
+        for (const grp of arr) {
+          if (!grp?.hooks) continue;
+          for (const h of grp.hooks) {
+            const cmd = typeof h?.command === 'string' ? h.command : '';
+            // P1-6b detection: forgen hook command path 식별. cross-platform (POSIX + Windows)
+            // 및 다양한 install 위치 (npm global, plugin cache, dev) 커버.
+            if (
+              cmd.includes('CLAUDE_PLUGIN_ROOT') ||
+              cmd.includes('/forgen-local/forgen/') ||
+              cmd.includes('\\forgen-local\\forgen\\') ||
+              cmd.includes('/forgen/dist/hooks/') ||
+              cmd.includes('\\forgen\\dist\\hooks\\') ||
+              cmd.includes('/@wooojin/forgen/') ||
+              cmd.includes('\\@wooojin\\forgen\\')
+            ) {
+              isExistingForgenUser = true;
+            }
+          }
+          if (isExistingForgenUser) break;
+        }
+        if (isExistingForgenUser) break;
+      }
+    } catch { /* settings.json 손상 시 fall-through, 단계 1 의 corrupt handling 이 처리 */ }
+  }
+
   // ── 1. settings.json 한 번 읽기 ──
   //
   // Audit finding #2/#10 (2026-04-21): prior `catch { settings = {} }`
@@ -765,12 +808,16 @@ function main() {
   }
 
   // ── 2. 플러그인 등록 (installed_plugins.json + skills) ──
+  // P1-6b (옵션 Y): 신규 사용자에게는 자동 install 안 함. 기존 forgen 사용자만 갱신.
+  // 사용자 host 선택 권한 보장 (1원칙 = Claude bias 제거).
   let plugin = false;
-  try {
-    plugin = registerPlugin();
-    if (plugin) applyPluginSettings(settings);
-  } catch (err) {
-    console.error(`[forgen] plugin registration failed: ${err?.message ?? err}`);
+  if (isExistingForgenUser) {
+    try {
+      plugin = registerPlugin();
+      if (plugin) applyPluginSettings(settings);
+    } catch (err) {
+      console.error(`[forgen] plugin registration failed: ${err?.message ?? err}`);
+    }
   }
 
   // ── 3. hooks.json 동적 생성 ──
@@ -800,29 +847,35 @@ function main() {
     }
   }
 
-  // ── 4. 슬래시 커맨드 설치 ──
+  // ── 4. 슬래시 커맨드 설치 ── (기존 사용자만)
   let commands = 0;
-  try {
-    commands = installSlashCommands();
-  } catch (err) {
-    console.error(`[forgen] slash commands failed: ${err?.message ?? err}`);
+  if (isExistingForgenUser) {
+    try {
+      commands = installSlashCommands();
+    } catch (err) {
+      console.error(`[forgen] slash commands failed: ${err?.message ?? err}`);
+    }
   }
 
-  // ── 5. settings에 훅 설정 적용 ──
+  // ── 5. settings에 훅 설정 적용 ── (기존 사용자만)
   let hooks = false;
-  try {
-    hooks = applyHookSettings(settings);
-  } catch (err) {
-    console.error(`[forgen] hooks settings failed: ${err?.message ?? err}`);
+  if (isExistingForgenUser) {
+    try {
+      hooks = applyHookSettings(settings);
+    } catch (err) {
+      console.error(`[forgen] hooks settings failed: ${err?.message ?? err}`);
+    }
   }
 
-  // ── 6. MCP 서버를 ~/.claude.json에 등록 (settings.json이 아닌 올바른 경로) ──
+  // ── 6. MCP 서버 ~/.claude.json 등록 ── (기존 사용자만)
   let mcp = false;
-  try {
-    mcp = applyMcpToClaudeJson();
-    cleanLegacyMcpFromSettings(settings);
-  } catch (err) {
-    console.error(`[forgen] MCP server registration failed: ${err?.message ?? err}`);
+  if (isExistingForgenUser) {
+    try {
+      mcp = applyMcpToClaudeJson();
+      cleanLegacyMcpFromSettings(settings);
+    } catch (err) {
+      console.error(`[forgen] MCP server registration failed: ${err?.message ?? err}`);
+    }
   }
 
   // ── 7. settings.json 한 번 쓰기 (atomic) ──
@@ -863,6 +916,28 @@ function main() {
   if (parts.length > 0) {
     console.log(`[forgen] Installed: ${parts.join(', ')} → ${HOME}`);
   }
+
+  // First-run banner (신규 사용자 안내) — feat/codex-support P1-6
+  if (!isExistingForgenUser) {
+    console.log('');
+    console.log('  ╭─ forgen — multi-host support ─────────────────────────────╮');
+    console.log('  │ binaries installed: forgen, fgx, forgen-mcp              │');
+    console.log('  │                                                            │');
+    console.log('  │ Next: register forgen on a host (Claude or Codex):        │');
+    console.log('  │   $ forgen install            (interactive 3-choice)      │');
+    console.log('  │   $ forgen install claude     (Claude only)               │');
+    console.log('  │   $ forgen install codex      (Codex only)                │');
+    console.log('  │   $ forgen install both       (둘 다)                      │');
+    console.log('  ╰────────────────────────────────────────────────────────────╯');
+    console.log('');
+  } else {
+    // 기존 사용자: default_host 안내
+    console.log('');
+    console.log('  [forgen] Multi-host support added. Existing forgen entry preserved.');
+    console.log('  Optional: `forgen config default-host {claude|codex|ask}` to set fgx default.');
+    console.log('  Optional: `forgen install codex` to register on Codex too.');
+    console.log('');
+  }
 }
 
 try {