@wooojin/forgen 0.4.1 → 0.4.4

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 {

package/skills/calibrate/SKILL.md

@@ -21,7 +21,8 @@ description: This skill should be used when the user asks to "calibrate, 캘리
 calibrate는 두 가지 데이터 소스를 사용합니다:
 
 ### 1차 소스: Evidence 파일
-`~/.forgen/me/evidence/` 디렉토리의 JSON 파일을 읽습니다.
+`~/.forgen/me/behavior/` 디렉토리의 JSON 파일을 읽습니다.
+(파일명: UUID.json — correction-record MCP 도구가 작성. 같은 디렉토리의 auto-*.md 는 auto-compound 산출이므로 calibrate 분석 대상 아님.)
 각 파일의 구조:
 ```json
 {
@@ -52,8 +53,8 @@ evidence 0건 + compound 교정 패턴 0건이면:
 ## Phase 1: Evidence 로드 및 검증
 
 ```bash
-ls ~/.forgen/me/evidence/ 2>/dev/null || echo "EMPTY"
-cat ~/.forgen/me/evidence/*.json 2>/dev/null || echo "NO_FILES"
+ls ~/.forgen/me/behavior/*.json 2>/dev/null || echo "EMPTY"
+cat ~/.forgen/me/behavior/*.json 2>/dev/null || echo "NO_FILES"
 ```
 
 로드한 JSON 파일마다 다음을 검증합니다:

package/skills/retro/SKILL.md

@@ -53,8 +53,8 @@ compound-list
 ### 1-3: 교정 기록
 
 ```bash
-ls -la ~/.forgen/me/evidence/ 2>/dev/null || echo "교정 데이터 없음"
-find ~/.forgen/me/evidence/ -name "*.json" -mtime -{period_days} 2>/dev/null | wc -l
+ls -la ~/.forgen/me/behavior/ 2>/dev/null || echo "교정 데이터 없음"
+find ~/.forgen/me/behavior/ -name "*.json" -mtime -{period_days} 2>/dev/null | wc -l
 ```
 
 ## Phase 2: 코드 활동 분석