@wooojin/forgen 0.4.6 → 0.4.8

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://claude.ai/schemas/claude-plugin.json",
   "name": "forgen",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "description": "Claude Code harness — the more you use Claude, the better it gets",
   "author": {
     "name": "jang-ujin",

package/CHANGELOG.md

@@ -7,6 +7,84 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.8] — 2026-05-15 — Codex 동등화 마무리 + 잔재 청소
+
+테마: v0.4.6 (Unattended Resilience) 이후 남아 있던 **Codex 동등화 마무리**
+(A 묶음) 와 v0.4.7 매트릭스 첫 활성화에서 노출된 **사전 존재 결함 청소**
+(E 묶음) 을 한 번에 정리.
+
+### Added
+- **A1**: Codex transcript FTS5 인덱싱 — `session-store.ts:indexCodexSession()`
+  신설. 이전엔 spawn.ts 가 `runtime === 'claude'` 가드로 Codex 세션을 SQLite
+  / FTS5 인덱싱에서 제외해 `session-search` MCP 도구가 Codex 대화를 회수
+  못 했음. Claude/Codex schema 별 함수 분기.
+- **A2**: corrupt profile 자동 복구 — `profileExists()=true && loadProfile()=null`
+  케이스 (parse 실패 / v1 shape 위반) 에서 `profile.json.corrupt-<ts>` 로
+  자동 backup → `needsOnboarding=true` 흐름. 데이터 손실 없음. `harness.ts`
+  가 backup 경로를 user-visible warning 으로 표시.
+- **A3**: `SESSIONS_DIR` (legacy session log) 와 `V1_SESSIONS_DIR` (v1 effective
+  state) 정합화 — `V1_DIRS` 에 `SESSIONS_DIR` 추가 (bootstrap early-return
+  경로에서도 보장), `forgen doctor` 가 두 dir 모두 노출, `paths.ts` 책임
+  주석 확장.
+- **E3**: `forgen doctor --repair` — plugin cache / installPath 검사 실패 시
+  `npm run build` + `node scripts/postinstall.js` 를 forgen pkgRoot 안에서
+  자동 실행. fail-open (실패해도 doctor 진단 흐름은 계속).
+
+### Fixed
+- **E1**: `notify.ts` spawn 'error' event 핸들러 — headless CI / Docker /
+  notifier 미설치 환경에서 `osascript`/`notify-send` ENOENT 가 unhandled
+  로 caller process 를 죽이던 사전 존재 버그. v0.4.7 CI 매트릭스 첫
+  활성화에서 노출. 추가로 `rate-limit-spawn-integration` 의 v0.4.7 CI
+  skip 가드를 제거 (production fail-safe 보장).
+- **E2**: biome lint warnings 24 건 → 0 — `biome --unsafe` 자동 fix 17
+  건 + 수동 fix 7 건 (`useTemplate`, `noAssignInExpressions`,
+  `noExplicitAny`, `noNonNullAssertion` 등 33 files touched).
+
+### Verified
+- vitest 2454 / 2454 PASS (이전 2442 + 새 회귀 가드 12: notify 2, profile-
+  corrupt 3, doctor-repair 5, codex-fts 2).
+- 로컬 build / lint 0 warning.
+- CI 매트릭스 (Linux x64 + arm64, macOS, Windows hooks-portability) 모두
+  PASS — 별도 PR 머지 (#31 부분) 후 본 PR 에서 다시 확인.
+
+## [0.4.7] — 2026-05-15 — fgx --codex 권한 플래그 수정
+
+### Fixed
+- `fgx --codex` 실행 시 `error: unexpected argument '--dangerously-skip-permissions' found`로
+  기동이 즉시 실패하던 버그를 수정. Codex CLI 는 동일 목적의 플래그가
+  `--dangerously-bypass-approvals-and-sandbox` 라 Claude 전용 플래그를 그대로
+  주입하면 거부됨.
+- `HostRuntime.dangerousSkipFlag` 추상화를 도입해 `src/fgx.ts` 가 런타임별로
+  올바른 플래그를 선택하도록 변경 (claude 동작은 회귀 없음).
+- 경고 배너와 `[forgen] Mode:` 라벨도 선택된 플래그/런타임에 맞춰 동적으로 출력.
+- **Windows 빌드 깨짐 (v0.4.4부터 누적)** 수정: `scripts/copy-assets.js`,
+  `src/cli.ts`, `src/host/install-orchestrator.ts` 가 `new URL(...).pathname` 으로
+  파일 경로를 만들었는데 Windows 에서 `/D:/...` 형태가 그대로 노출되어
+  `mkdirSync` 가 `D:\D:\...` 로 해석 → ENOENT. `fileURLToPath()` 로 일괄 교체.
+- **Linux CI test 잡 회귀** 수정: `npm run build` 만으로는 `hooks/hooks.json` 이
+  생성되지 않아 (prepack 시점에만 생성) `claude-code-compat.test.ts` 등이
+  실패. `.github/workflows/ci.yml` 의 test 잡에 `node scripts/prepack-hooks.cjs`
+  단계를 추가하여 CI 환경에서도 hooks.json 이 준비된 상태로 vitest 가 돌도록.
+
+### CI / Platform Coverage
+- `ci.yml` test 잡을 OS × Node 매트릭스로 확장:
+  ubuntu-latest × {20, 22}, macos-latest × {20, 22}, ubuntu-24.04-arm × 22.
+  이전엔 vitest 풀 매트릭스가 ubuntu-latest 만 돌았음.
+- **Windows**: hooks-portability 잡 (Node 20.x, 22.x × windows-latest) 에서
+  빌드 + postinstall + 21/21 hook 로드를 검증. 풀 vitest 는 다수 통합
+  테스트가 `/tmp` / POSIX path / bash spawn 가정에 묶여 있어 cross-platform
+  재작성이 별도 트랙. 현재 Windows 사용자의 실사용 경로 (`npm i -g` +
+  Claude/Codex hook 발동) 는 보장됨.
+- `actions/checkout` 에 `fetch-depth: 0` 추가 — `tests/git-stats.test.ts`
+  가 실 git log 30일 윈도우를 분석.
+- CI 환경 의존 테스트 (`rate-limit-spawn-integration`, `claude-integration`
+  의 6-live / 3-live) 에 `it.skipIf(!!process.env.CI)` 가드.
+
+### Verified
+- vitest 2442/2442 PASS, Docker e2e 77/77 PASS.
+- `node dist/fgx.js --codex` / `--claude` 직접 기동 확인 — Codex CLI 가 플래그 수용.
+- `npm run build` + `prepack-hooks` 후 `hooks/hooks.json` 21/21 active 재생성 확인.
+
 ## [0.4.6] — 2026-05-14 — Unattended Execution Resilience
 
 긴 무인 실행 (`forge-loop --goal-only` 새벽 실행, eval N=33+ sequential measurement)

package/dist/checks/self-score-deflation.js

@@ -50,12 +50,13 @@ const SELF_SCORE_PATTERNS = [
 function extractDeltas(text) {
     const re = /(\d+(?:\.\d+)?)\s*(?:→|->|–>|~>)\s*(\d+(?:\.\d+)?)/g;
     const out = [];
-    let m;
-    while ((m = re.exec(text)) !== null) {
+    let m = re.exec(text);
+    while (m !== null) {
         const from = Number(m[1]);
         const to = Number(m[2]);
         if (Number.isFinite(from) && Number.isFinite(to))
             out.push({ from, to });
+        m = re.exec(text);
     }
     return out;
 }
@@ -66,9 +67,10 @@ function findScoreSignals(text, max = 3) {
             break;
         // 각 호출마다 lastIndex 초기화를 위해 새 RegExp 생성
         const re = new RegExp(p.source, p.flags);
-        let m;
-        while ((m = re.exec(text)) !== null && out.length < max) {
+        let m = re.exec(text);
+        while (m !== null && out.length < max) {
             out.push(m[0]);
+            m = re.exec(text);
         }
     }
     return out;

package/dist/cli.js

@@ -195,7 +195,7 @@ const commands = [
                 console.log('Usage:\n  forgen parity codex [--dry-run]\n\nNotes:\n  - source 체크아웃에서만 작동합니다 (tests/ 디렉토리 필요).\n  - npm install 로 설치된 패키지에서는 run-parity.sh 가 없습니다.');
                 return;
             }
-            const here = path.dirname(new URL(import.meta.url).pathname);
+            const here = path.dirname(fileURLToPath(import.meta.url));
             const scriptPath = path.resolve(here, '..', 'tests', 'e2e', 'codex', 'run-parity.sh');
             if (!fs.existsSync(scriptPath)) {
                 console.error('[forgen] run-parity.sh 는 source 체크아웃에서만 작동. 직접 git clone 후 실행하세요.');
@@ -237,10 +237,13 @@ const commands = [
     },
     {
         name: 'doctor',
-        description: 'Diagnostics (--prune-state to GC stale session files)',
+        description: 'Diagnostics (--prune-state to GC stale session files, --repair to auto-fix plugin cache)',
         handler: async (args) => {
             const { runDoctor } = await import('./core/doctor.js');
-            await runDoctor({ pruneState: args.includes('--prune-state') });
+            await runDoctor({
+                pruneState: args.includes('--prune-state'),
+                repair: args.includes('--repair'),
+            });
         },
     },
     // install --plugin 제거됨 — postinstall이 유일한 설치 경로

package/dist/core/auto-compound-runner.js

@@ -219,8 +219,12 @@ function validateSolutionFiles(dirBefore) {
 function extractText(c) {
     if (typeof c === 'string')
         return c;
-    if (Array.isArray(c))
-        return c.filter((x) => x?.type === 'text').map((x) => x.text ?? '').join('\n');
+    if (Array.isArray(c)) {
+        return c
+            .filter((x) => typeof x === 'object' && x !== null && x.type === 'text')
+            .map((x) => (typeof x.text === 'string' ? x.text : ''))
+            .join('\n');
+    }
     return '';
 }
 /**

package/dist/core/dashboard.js

@@ -40,13 +40,13 @@ function dim(s) { return `${DIM}${s}${RESET}`; }
 function cyan(s) { return `${CYAN}${s}${RESET}`; }
 // ── Box-drawing table helpers ──
 function tableRow(cols, widths) {
-    return '  │ ' + cols.map((c, i) => c.padEnd(widths[i])).join(' │ ') + ' │';
+    return `  │ ${cols.map((c, i) => c.padEnd(widths[i])).join(' │ ')} │`;
 }
 function tableSep(widths, top = false, bottom = false) {
     const left = top ? '┌' : bottom ? '└' : '├';
     const mid = top ? '┬' : bottom ? '┴' : '┼';
     const right = top ? '┐' : bottom ? '┘' : '┤';
-    return '  ' + left + widths.map(w => '─'.repeat(w + 2)).join(mid) + right;
+    return `  ${left}${widths.map(w => '─'.repeat(w + 2)).join(mid)}${right}`;
 }
 // ── Data Collection Functions ──
 /** Read all .md files in a directory and return their frontmatter. */

package/dist/core/doctor.d.ts

@@ -2,5 +2,15 @@ export interface DoctorOptions {
     /** When true, delete stale session-scoped state files instead of just
      *  reporting bloat. Triggered by `forgen doctor --prune-state`. */
     pruneState?: boolean;
+    /**
+     * When true, auto-fix recoverable failures (e.g. missing plugin cache /
+     * stale installPath) by running `npm run build` + `node scripts/postinstall.js`
+     * inside the forgen install directory. Triggered by `forgen doctor --repair`.
+     *
+     * v0.4.8 (E3) — 이전엔 안내문 ("Fix: npm run build && node scripts/postinstall.js")
+     * 만 출력했고 사용자가 직접 실행해야 했음. fail-open: repair 실패해도
+     * doctor 흐름은 정상 종료.
+     */
+    repair?: boolean;
 }
 export declare function runDoctor(opts?: DoctorOptions): Promise<void>;

package/dist/core/doctor.js

@@ -2,7 +2,8 @@ import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { execFileSync } from 'node:child_process';
-import { FORGEN_HOME, LAB_DIR, ME_BEHAVIOR, ME_DIR, ME_SOLUTIONS, ME_RULES, ME_SKILLS, PACKS_DIR, SESSIONS_DIR, STATE_DIR } from './paths.js';
+import { fileURLToPath } from 'node:url';
+import { FORGEN_HOME, LAB_DIR, ME_BEHAVIOR, ME_DIR, ME_SOLUTIONS, ME_RULES, ME_SKILLS, PACKS_DIR, SESSIONS_DIR, STATE_DIR, V1_SESSIONS_DIR } from './paths.js';
 import { getTimingStats } from '../hooks/shared/hook-timing.js';
 import { countSessionScopedFiles, pruneState } from './state-gc.js';
 import { summarizeAllByHost } from '../store/host-mismatch.js';
@@ -87,6 +88,29 @@ function renderCodexParity() {
         console.log(`  ✓ Codex parity green (last run: ${timeStr},${version})`);
     }
 }
+/**
+ * v0.4.8 (E3): plugin cache / installPath 진단이 실패했을 때 자동 복구.
+ * forgen 패키지 디렉토리에서 `npm run build` + postinstall 을 차례로 실행.
+ * 실패해도 doctor 자체는 계속 진행 (fail-open).
+ */
+function attemptPluginRepair() {
+    try {
+        // forgen 패키지 루트 = 현재 파일에서 dist/core/doctor.js 위치 → pkgRoot.
+        // dev (src/) 와 prod (dist/) 양쪽 모두 path.resolve(...,'..','..') 로 도달.
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        const pkgRoot = path.resolve(here, '..', '..');
+        console.log(`\n  [Repair] forgen 패키지 자가복구 시도 — ${pkgRoot}`);
+        execFileSync('npm', ['run', 'build'], { cwd: pkgRoot, stdio: 'inherit' });
+        execFileSync('node', ['scripts/postinstall.js'], { cwd: pkgRoot, stdio: 'inherit' });
+        console.log('  [Repair] 완료. 진단 재실행 권장: forgen doctor');
+        return true;
+    }
+    catch (e) {
+        console.warn(`  [Repair] 실패: ${e instanceof Error ? e.message : String(e)}`);
+        console.warn('  [Repair] 수동 복구: cd <forgen pkgRoot> && npm run build && node scripts/postinstall.js');
+        return false;
+    }
+}
 export async function runDoctor(opts = {}) {
     failedChecks = [];
     console.log('\n  Forgen — Diagnostics\n');
@@ -114,7 +138,9 @@ export async function runDoctor(opts = {}) {
         });
         forgenPluginCacheOk = versions.length > 0;
     }
-    check('forgen plugin cache', forgenPluginCacheOk, 'Hook execution requires plugin cache. Fix: npm run build && node scripts/postinstall.js');
+    check('forgen plugin cache', forgenPluginCacheOk, opts.repair
+        ? 'Hook execution requires plugin cache. Attempting auto-repair (--repair)…'
+        : 'Hook execution requires plugin cache. Fix: npm run build && node scripts/postinstall.js (or rerun with --repair)');
     // installed_plugins.json 정합성 확인
     const installedPluginsPath = path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
     let pluginRegistered = false;
@@ -129,7 +155,15 @@ export async function runDoctor(opts = {}) {
         }
         catch { /* ignore */ }
     }
-    check('forgen plugin registered & installPath exists', pluginRegistered, 'Plugin registered but installPath missing on disk. Fix: npm run build && node scripts/postinstall.js');
+    check('forgen plugin registered & installPath exists', pluginRegistered, opts.repair
+        ? 'Plugin registered but installPath missing on disk. Attempting auto-repair (--repair)…'
+        : 'Plugin registered but installPath missing on disk. Fix: npm run build && node scripts/postinstall.js (or rerun with --repair)');
+    // v0.4.8 (E3): plugin cache 또는 installPath 가 깨졌고 --repair 가 켜져
+    // 있으면 build + postinstall 자동 실행. doctor 진단 자체는 계속 진행하여
+    // 사용자가 다른 health 항목도 한 번에 확인 가능.
+    if (opts.repair && (!forgenPluginCacheOk || !pluginRegistered)) {
+        attemptPluginRepair();
+    }
     console.log();
     section('Directories');
     check('~/.forgen/', exists(FORGEN_HOME));
@@ -138,7 +172,8 @@ export async function runDoctor(opts = {}) {
     check('~/.forgen/me/behavior/', exists(ME_BEHAVIOR));
     check('~/.forgen/me/rules/', exists(ME_RULES));
     check('~/.forgen/packs/', exists(PACKS_DIR));
-    check('~/.forgen/sessions/', exists(SESSIONS_DIR));
+    check('~/.forgen/sessions/ (session logs)', exists(SESSIONS_DIR));
+    check('~/.forgen/state/sessions/ (v1 effective state)', exists(V1_SESSIONS_DIR));
     // R9-IA5: warn if a user dropped rule files at ~/.forgen/rules/ by mistake.
     // That path is NOT loaded — personal rules live at ~/.forgen/me/rules/.
     const legacyRulesPath = path.join(FORGEN_HOME, 'rules');
@@ -194,10 +229,16 @@ export async function runDoctor(opts = {}) {
     }
     console.log();
     console.log('  [Log Locations]');
-    console.log(`  Session logs: ${SESSIONS_DIR}`);
+    console.log(`  Session logs:       ${SESSIONS_DIR}`);
     if (exists(SESSIONS_DIR)) {
         const sessionCount = fs.readdirSync(SESSIONS_DIR).filter((f) => f.endsWith('.json')).length;
-        console.log(`  Saved sessions: ${sessionCount}`);
+        console.log(`  Saved sessions:     ${sessionCount}`);
+    }
+    // v0.4.8 (A3): v1 effective state directory 도 가시화 — 두 dir 책임 다름.
+    console.log(`  V1 effective state: ${V1_SESSIONS_DIR}`);
+    if (exists(V1_SESSIONS_DIR)) {
+        const stateCount = fs.readdirSync(V1_SESSIONS_DIR).filter((f) => f.endsWith('.json')).length;
+        console.log(`  V1 state count:     ${stateCount}`);
     }
     console.log(`  Claude Code sessions: ${CLAUDE_PROJECTS_DIR}`);
     console.log();
@@ -244,7 +285,7 @@ export async function runDoctor(opts = {}) {
     }
     else {
         console.log('  Hook                  Count   p50ms   p95ms   max ms');
-        console.log('  ' + '-'.repeat(56));
+        console.log(`  ${'-'.repeat(56)}`);
         for (const s of timingStats) {
             const hook = s.hook.padEnd(22);
             const count = String(s.count).padStart(5);
@@ -499,7 +540,7 @@ export async function runDoctor(opts = {}) {
         for (const f of failedChecks) {
             if (!bySection.has(f.section))
                 bySection.set(f.section, []);
-            bySection.get(f.section).push(f);
+            bySection.get(f.section)?.push(f);
         }
         for (const [sec, items] of bySection) {
             console.log(`    [${sec}]`);

package/dist/core/harness.js

@@ -165,7 +165,7 @@ function ensureCompoundMemory(cwd) {
             const content = fs.readFileSync(memoryMdPath, 'utf-8');
             if (content.includes('compound-index.md'))
                 return;
-            fs.writeFileSync(memoryMdPath, content.trimEnd() + '\n' + compoundPointer + '\n');
+            fs.writeFileSync(memoryMdPath, `${content.trimEnd()}\n${compoundPointer}\n`);
         }
         const indexPath = path.join(memoryDir, 'compound-index.md');
         const solutionsDir = ME_SOLUTIONS;
@@ -262,7 +262,7 @@ function migrateToForgen() {
         catch (e) {
             log.debug(`migrateToForgen: ${legacyHome} 파일 복사 중 오류`, e);
         }
-        const backupPath = legacyHome + '.bak';
+        const backupPath = `${legacyHome}.bak`;
         try {
             if (!fs.existsSync(backupPath)) {
                 fs.renameSync(legacyHome, backupPath);
@@ -348,6 +348,12 @@ export async function prepareHarness(cwd, options = {}) {
         if (v1Result.legacyBackupPath) {
             log.debug(`v1: 레거시 프로필 백업 완료 → ${v1Result.legacyBackupPath}`);
         }
+        if (v1Result.corruptProfileBackupPath) {
+            // v0.4.8 — corrupt profile auto-repair 결과는 debug 가 아닌 user-visible warning.
+            // 사용자가 onboarding 으로 보내지는 이유를 알 수 있도록.
+            console.warn(`  ⚠  forgen: profile.json 이 깨져 있어 옆에 백업해두고 onboarding 으로 보냅니다.`);
+            console.warn(`  ⚠  backup: ${v1Result.corruptProfileBackupPath}`);
+        }
         if (v1Result.session) {
             const { session } = v1Result;
             log.debug(`v1 세션 시작: ${session.quality_pack}/${session.autonomy_pack}, trust=${session.effective_trust_policy}`);

package/dist/core/inspect-cli.js

@@ -21,7 +21,7 @@ export async function handleInspect(args) {
             console.log('\n  No v1 profile found. Run onboarding first.\n');
             return;
         }
-        console.log('\n' + inspect.renderProfile(profile) + '\n');
+        console.log(`\n${inspect.renderProfile(profile)}\n`);
         // ── Learning Loop Status ──
         const activeRules = loadActiveRules();
         const rulesByScope = {
@@ -75,13 +75,13 @@ export async function handleInspect(args) {
     }
     if (sub === 'rules') {
         const rules = loadAllRules();
-        console.log('\n' + inspect.renderRules(rules) + '\n');
+        console.log(`\n${inspect.renderRules(rules)}\n`);
         return;
     }
     // R9-IA2: user-facing name is "corrections"; "evidence" kept as back-compat alias.
     if (sub === 'corrections' || sub === 'evidence') {
         const evidence = loadRecentEvidence(20);
-        console.log('\n' + inspect.renderEvidence(evidence) + '\n');
+        console.log(`\n${inspect.renderEvidence(evidence)}\n`);
         return;
     }
     if (sub === 'session') {
@@ -90,7 +90,7 @@ export async function handleInspect(args) {
             console.log('\n  No session state found.\n');
             return;
         }
-        console.log('\n' + inspect.renderSession(sessions[0]) + '\n');
+        console.log(`\n${inspect.renderSession(sessions[0])}\n`);
         return;
     }
     // R5-G1: 2AM 디버깅용 jsonl tail — violations/bypass/drift

package/dist/core/migrate-evidence-host.js

@@ -35,7 +35,7 @@ export function migrateEvidenceHost(options) {
             skipped++;
             continue;
         }
-        const host = data['host'];
+        const host = data.host;
         if (host === 'claude' || host === 'codex') {
             skipped++;
             continue;

package/dist/core/notify.js

@@ -37,6 +37,9 @@ function notifyDarwin(title, body) {
     try {
         const script = `display notification "${escapeForOsascript(body)}" with title "${escapeForOsascript(title)}"`;
         const child = spawn('osascript', ['-e', script], { detached: true, stdio: 'ignore' });
+        // ENOENT 등 spawn 실패는 동기 throw 가 아니라 'error' event 로 emit 됨.
+        // 핸들러 없으면 unhandled 로 process crash → headless CI 회귀 가드.
+        child.on('error', (e) => log.debug('osascript notification 실패 (event)', e));
         child.unref();
     }
     catch (e) {
@@ -47,6 +50,10 @@ function notifyDarwin(title, body) {
 function notifyLinux(title, body) {
     try {
         const child = spawn('notify-send', [title, body], { detached: true, stdio: 'ignore' });
+        // headless 환경 (CI, Docker) 에서 notify-send 부재 시 ENOENT 가 'error' event 로 emit.
+        // 핸들러 없으면 unhandled 로 caller 프로세스 죽음 — rate-limit-spawn-integration
+        // CI 실패의 사전 존재 원인.
+        child.on('error', (e) => log.debug('notify-send 실패 (event)', e));
         child.unref();
     }
     catch (e) {

package/dist/core/paths.d.ts

@@ -60,7 +60,15 @@ export declare const OUTCOMES_DIR: string;
 export declare const CANDIDATES_DIR: string;
 /** ~/.forgen/lab/archived/ — rollback destination for evolved solutions. */
 export declare const ARCHIVED_DIR: string;
-/** ~/.forgen/sessions/ — 세션 로그 */
+/**
+ * ~/.forgen/sessions/ — legacy session log directory (transcript-like).
+ *
+ * session-logger.ts 가 prepareHarness step 11 에서 한 줄짜리
+ * `{date}_{uuid}.json` 메타 파일을 기록. v1 의 SessionEffectiveState
+ * 와는 다른 책임이라 별 디렉토리 (V1_SESSIONS_DIR) 와 공존:
+ *   - SESSIONS_DIR (여기): 세션 발생 사실 + 시작/종료 시각 + cwd
+ *   - V1_SESSIONS_DIR     : profile + pack 합성 결과 (effective state)
+ */
 export declare const SESSIONS_DIR: string;
 /** ~/.forgen/config.json — 글로벌 설정 */
 export declare const GLOBAL_CONFIG: string;
@@ -72,7 +80,13 @@ export declare const LAB_DIR: string;
 export declare const FORGE_PROFILE: string;
 /** ~/.forgen/me/recommendations/ — Pack Recommendation */
 export declare const V1_RECOMMENDATIONS_DIR: string;
-/** ~/.forgen/state/sessions/ — Session Effective State */
+/**
+ * ~/.forgen/state/sessions/ — v1 Session Effective State.
+ *
+ * session-state-store.ts 가 매 세션마다 profile + active rules + pack
+ * 합성 결과를 `{sessionId}.json` 으로 기록. SESSIONS_DIR (legacy session
+ * log) 와는 다른 책임 (정합화는 v0.4.8 A3 참조).
+ */
 export declare const V1_SESSIONS_DIR: string;
 /** ~/.forgen/state/raw-logs/ — Raw Log */
 export declare const V1_RAW_LOGS_DIR: string;

package/dist/core/paths.js

@@ -65,7 +65,15 @@ export const OUTCOMES_DIR = path.join(STATE_DIR, 'outcomes');
 export const CANDIDATES_DIR = path.join(FORGEN_HOME, 'lab', 'candidates');
 /** ~/.forgen/lab/archived/ — rollback destination for evolved solutions. */
 export const ARCHIVED_DIR = path.join(FORGEN_HOME, 'lab', 'archived');
-/** ~/.forgen/sessions/ — 세션 로그 */
+/**
+ * ~/.forgen/sessions/ — legacy session log directory (transcript-like).
+ *
+ * session-logger.ts 가 prepareHarness step 11 에서 한 줄짜리
+ * `{date}_{uuid}.json` 메타 파일을 기록. v1 의 SessionEffectiveState
+ * 와는 다른 책임이라 별 디렉토리 (V1_SESSIONS_DIR) 와 공존:
+ *   - SESSIONS_DIR (여기): 세션 발생 사실 + 시작/종료 시각 + cwd
+ *   - V1_SESSIONS_DIR     : profile + pack 합성 결과 (effective state)
+ */
 export const SESSIONS_DIR = path.join(FORGEN_HOME, 'sessions');
 /** ~/.forgen/config.json — 글로벌 설정 */
 export const GLOBAL_CONFIG = path.join(FORGEN_HOME, 'config.json');
@@ -77,7 +85,13 @@ export const LAB_DIR = path.join(FORGEN_HOME, 'lab');
 export const FORGE_PROFILE = path.join(ME_DIR, 'forge-profile.json');
 /** ~/.forgen/me/recommendations/ — Pack Recommendation */
 export const V1_RECOMMENDATIONS_DIR = path.join(ME_DIR, 'recommendations');
-/** ~/.forgen/state/sessions/ — Session Effective State */
+/**
+ * ~/.forgen/state/sessions/ — v1 Session Effective State.
+ *
+ * session-state-store.ts 가 매 세션마다 profile + active rules + pack
+ * 합성 결과를 `{sessionId}.json` 으로 기록. SESSIONS_DIR (legacy session
+ * log) 와는 다른 책임 (정합화는 v0.4.8 A3 참조).
+ */
 export const V1_SESSIONS_DIR = path.join(STATE_DIR, 'sessions');
 /** ~/.forgen/state/raw-logs/ — Raw Log */
 export const V1_RAW_LOGS_DIR = path.join(STATE_DIR, 'raw-logs');

package/dist/core/session-store.d.ts

@@ -6,7 +6,18 @@
  * 외부 의존성 없음 — Node.js 22+ 내장 node:sqlite 사용.
  */
 /**
- * Transcript JSONL을 SQLite에 인덱싱.
+ * v0.4.8 (A1): Codex transcript JSONL 을 SQLite 에 인덱싱.
+ *
+ * Codex schema (Claude 와 다름):
+ *   {type: 'response_item', payload: {type: 'message', role: 'user'|'assistant',
+ *    content: [{type: 'input_text'|'output_text', text: '...'}]}}
+ *
+ * 결정 (v0.4.8 A1): Claude/Codex 통합 abstraction 대신 분기 함수 두 개로
+ * 처리. 미래에 host 가 추가될 때 통합 추상화로 리팩터.
+ */
+export declare function indexCodexSession(cwd: string, transcriptPath: string, sessionId: string): Promise<void>;
+/**
+ * Transcript JSONL을 SQLite에 인덱싱. (Claude schema)
  */
 export declare function indexSession(cwd: string, transcriptPath: string, sessionId: string): Promise<void>;
 /**

package/dist/core/session-store.js

@@ -69,8 +69,80 @@ function openDb() {
         return null;
     }
 }
+/** Codex content array → flat string. content: [{type: 'input_text', text: ...}, ...] */
+function extractCodexText(content) {
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const item of content) {
+        if (item && typeof item === 'object' && 'text' in item && typeof item.text === 'string') {
+            parts.push(item.text);
+        }
+    }
+    return parts.join('\n').trim();
+}
+/**
+ * v0.4.8 (A1): Codex transcript JSONL 을 SQLite 에 인덱싱.
+ *
+ * Codex schema (Claude 와 다름):
+ *   {type: 'response_item', payload: {type: 'message', role: 'user'|'assistant',
+ *    content: [{type: 'input_text'|'output_text', text: '...'}]}}
+ *
+ * 결정 (v0.4.8 A1): Claude/Codex 통합 abstraction 대신 분기 함수 두 개로
+ * 처리. 미래에 host 가 추가될 때 통합 추상화로 리팩터.
+ */
+export async function indexCodexSession(cwd, transcriptPath, sessionId) {
+    const db = openDb();
+    if (!db)
+        return;
+    try {
+        const existing = db.prepare('SELECT id FROM sessions WHERE id = ?').get(sessionId);
+        if (existing)
+            return;
+        const content = fs.readFileSync(transcriptPath, 'utf-8');
+        const lines = content.split('\n').filter(Boolean);
+        db.prepare('INSERT INTO sessions (id, cwd, started_at, message_count) VALUES (?, ?, ?, 0)').run(sessionId, cwd, new Date().toISOString());
+        let messageCount = 0;
+        const insertMsg = db.prepare('INSERT INTO messages (session_id, role, content, timestamp) VALUES (?, ?, ?, ?)');
+        for (const line of lines) {
+            try {
+                const entry = JSON.parse(line);
+                if (entry.type !== 'response_item' || !entry.payload)
+                    continue;
+                const role = entry.payload.role;
+                if (role !== 'user' && role !== 'assistant')
+                    continue;
+                const text = extractCodexText(entry.payload.content);
+                if (!text)
+                    continue;
+                const truncated = text.slice(0, 10000);
+                const ts = typeof entry.timestamp === 'string' ? entry.timestamp : '';
+                const result = insertMsg.run(sessionId, role, truncated, ts);
+                if (fts5Available) {
+                    try {
+                        db.prepare('INSERT INTO messages_fts(rowid, content) VALUES (?, ?)').run(result.lastInsertRowid, truncated);
+                    }
+                    catch { /* FTS sync failure */ }
+                }
+                messageCount++;
+            }
+            catch { /* skip malformed lines */ }
+        }
+        db.prepare('UPDATE sessions SET message_count = ? WHERE id = ?').run(messageCount, sessionId);
+        log.debug(`Codex 세션 인덱싱 완료: ${sessionId} (${messageCount} messages)`);
+    }
+    catch (e) {
+        log.debug('Codex 세션 인덱싱 실패', e);
+    }
+    finally {
+        try {
+            db.close();
+        }
+        catch { /* ignore */ }
+    }
+}
 /**
- * Transcript JSONL을 SQLite에 인덱싱.
+ * Transcript JSONL을 SQLite에 인덱싱. (Claude schema)
  */
 export async function indexSession(cwd, transcriptPath, sessionId) {
     const db = openDb();

package/dist/core/spawn.js

@@ -160,11 +160,19 @@ async function runAutoCompound(cwd, transcriptPath, sessionId) {
 }
 /**
  * Transcript를 SQLite FTS5에 인덱싱 (추후 session-search MCP 도구용).
+ *
+ * v0.4.8 (A1): runtime 별 schema 차이로 분기. Claude 는 `entry.type === 'user'|
+ * 'assistant'`, Codex 는 `entry.type === 'response_item' && entry.payload.role`.
  */
-async function indexTranscriptToFTS(cwd, transcriptPath, sessionId) {
+async function indexTranscriptToFTS(cwd, transcriptPath, sessionId, runtime = 'claude') {
     try {
-        const { indexSession } = await import('./session-store.js');
-        await indexSession(cwd, transcriptPath, sessionId);
+        const store = await import('./session-store.js');
+        if (runtime === 'codex') {
+            await store.indexCodexSession(cwd, transcriptPath, sessionId);
+        }
+        else {
+            await store.indexSession(cwd, transcriptPath, sessionId);
+        }
     }
     catch (e) {
         log.debug('FTS5 인덱싱 실패 (session-store 미구현 시 정상)', e);
@@ -225,10 +233,8 @@ export async function spawnClaude(args, context, runtime = 'claude') {
                     else {
                         sessionId = path.basename(transcript, '.jsonl');
                     }
-                    // 1. FTS5 인덱싱 (claude only — codex schema FTS 호환은 미검증, 별도 작업)
-                    if (runtime === 'claude') {
-                        await indexTranscriptToFTS(context.cwd, transcript, sessionId);
-                    }
+                    // 1. FTS5 인덱싱 — v0.4.8 (A1) 부터 Claude/Codex 모두 지원.
+                    await indexTranscriptToFTS(context.cwd, transcript, sessionId, runtime);
                     // 2. 자동 compound (10+ user 메시지인 경우만) — 양 runtime 호환
                     const userMsgCount = await countUserMessages(transcript);
                     if (userMsgCount >= 10) {

package/dist/core/v1-bootstrap.d.ts

@@ -18,6 +18,13 @@ export declare function ensureV1Directories(): void;
 export interface V1BootstrapResult {
     needsOnboarding: boolean;
     legacyBackupPath: string | null;
+    /**
+     * profile.json 이 존재했지만 parse/shape 오류로 사용 불가하여 v0.4.8
+     * 의 auto-repair 가 timestamp 백업으로 치워둔 경로. legacyBackupPath
+     * 와 의미가 다름 (legacy = model_version 구 버전 cutover, corrupt =
+     * 깨진 파일 격리).
+     */
+    corruptProfileBackupPath: string | null;
     session: SessionEffectiveState | null;
     renderedRules: string | null;
     profile: Profile | null;