@wooojin/forgen 0.4.4 → 0.4.6

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

@@ -11,7 +11,9 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { execFileSync } from 'node:child_process';
+import { execFileSync, execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
 import { createRequire } from 'node:module';
 import { containsPromptInjection, filterSolutionContent } from '../hooks/prompt-injection-filter.js';
 import { redactSecrets } from '../hooks/secret-filter.js';
@@ -78,6 +80,58 @@ function execClaudeRetry(args, opts) {
     });
     return r.message;
 }
+/**
+ * 0.4.6 perf #12 — async 변형. 3 LLM 호출 (solution / user-pattern / learning) 을
+ * Promise.allSettled 로 병렬 실행하여 wall-clock 을 sum → max 로 단축 (~3x).
+ *
+ * 0.4.6 에서는 adaptive cooldown 으로 wasted runs 차단을 우선 적용했고, 호출부
+ * full parallelization 은 0.4.7 로 분리 (refactor surface 큼 — solution call 의
+ * `--allowedTools` sandbox 와 file-write 순서 invariant 검증 필요).
+ *
+ * 본 함수는 0.4.7 작업의 foundation 으로 박제 — export 하여 unused warning 회피.
+ * 동작은 sync 버전과 동일: Claude/Codex 분기 + retry on transient.
+ */
+export async function execClaudeRetryAsync(args, opts) {
+    const mod = createRequire(import.meta.url)('../host/exec-host.js');
+    const profileMod = createRequire(import.meta.url)('../store/profile-store.js');
+    const resolved = profileMod.resolveDefaultHost();
+    const host = resolved === 'codex' ? 'codex' : 'claude';
+    if (host === 'claude') {
+        const TRANSIENT = /ETIMEDOUT|ECONNRESET|ECONNREFUSED|EPIPE/;
+        const MAX_ATTEMPTS = 2;
+        for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+            try {
+                const { stdout } = await execFileAsync('claude', args, opts);
+                return typeof stdout === 'string' ? stdout : stdout.toString();
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                const match = msg.match(TRANSIENT);
+                if (attempt < MAX_ATTEMPTS && match) {
+                    process.stderr.write(`[forgen-auto-compound] ${match[0]} on attempt ${attempt}/${MAX_ATTEMPTS}, retrying in 3s (auto-recovery)...\n`);
+                    await new Promise(resolve => setTimeout(resolve, 3000));
+                    continue;
+                }
+                throw e;
+            }
+        }
+        throw new Error('unreachable');
+    }
+    // codex 분기 (동기 execHost 라 그냥 호출 — 이미 빠름)
+    const pIdx = args.indexOf('-p');
+    if (pIdx === -1 || !args[pIdx + 1]) {
+        throw new Error('execClaudeRetryAsync: codex host requires -p prompt argument');
+    }
+    const prompt = args[pIdx + 1];
+    const modelIdx = args.indexOf('--model');
+    const model = modelIdx !== -1 ? args[modelIdx + 1] : undefined;
+    const r = mod.execHost({
+        prompt, model, host: 'codex',
+        timeout: typeof opts.timeout === 'number' ? opts.timeout : 60000,
+        cwd: typeof opts.cwd === 'string' ? opts.cwd : undefined,
+    });
+    return r.message;
+}
 const [, , cwd, transcriptPath, sessionId] = process.argv;
 if (!cwd || !transcriptPath || !sessionId) {
     process.exit(1);
@@ -169,6 +223,12 @@ function extractText(c) {
         return c.filter((x) => x?.type === 'text').map((x) => x.text ?? '').join('\n');
     return '';
 }
+/**
+ * 0.4.6 — claude/codex JSONL 양 schema 호환.
+ *
+ * Claude: {type: 'user'|'assistant', content: ...}
+ * Codex: {type: 'response_item', payload: {type: 'message', role: 'user'|'assistant', content: [{type: 'input_text', text: ...}]}}
+ */
 function extractSummary(filePath, maxChars = 8000) {
     const content = fs.readFileSync(filePath, 'utf-8');
     const lines = content.split('\n').filter(Boolean);
@@ -177,6 +237,7 @@ function extractSummary(filePath, maxChars = 8000) {
     for (const line of lines) {
         try {
             const entry = JSON.parse(line);
+            // Claude schema
             if (entry.type === 'user' || entry.type === 'queue-operation') {
                 const text = extractText(entry.content);
                 if (text) {
@@ -191,6 +252,21 @@ function extractSummary(filePath, maxChars = 8000) {
                     totalChars += text.length;
                 }
             }
+            // Codex schema
+            else if (entry.type === 'response_item' && entry.payload?.role === 'user') {
+                const text = extractCodexText(entry.payload.content);
+                if (text) {
+                    messages.push(`[User] ${text.slice(0, 500)}`);
+                    totalChars += text.length;
+                }
+            }
+            else if (entry.type === 'response_item' && entry.payload?.role === 'assistant') {
+                const text = extractCodexText(entry.payload.content);
+                if (text) {
+                    messages.push(`[Assistant] ${text.slice(0, 500)}`);
+                    totalChars += text.length;
+                }
+            }
         }
         catch { /* skip */ }
         if (totalChars > maxChars)
@@ -198,6 +274,18 @@ function extractSummary(filePath, maxChars = 8000) {
     }
     return messages.join('\n\n');
 }
+/** 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();
+}
 /**
  * 기존 behavior 파일에 유사 패턴이 있으면 observedCount를 +1 증가.
  * 유사도는 같은 kind + 내용 키워드 50%+ 겹침으로 판단.
@@ -242,6 +330,8 @@ function mergeOrCreateBehavior(dir, newContent, kind, today) {
     }
     return false;
 }
+// 0.4.6 perf #12 — adaptive cooldown 시그널 (declared early for hoisting).
+let userPatternFound = false;
 try {
     const rawSummary = extractSummary(transcriptPath);
     if (rawSummary.length < 200)
@@ -375,6 +465,7 @@ ${sanitizedSummary.slice(0, 4000)}
             process.stderr.write(`[forgen-auto-compound] behavior: injection detected in LLM output, skipping write\n`);
         }
         if (userResult && !isInjection && !userResult.includes('관찰된 패턴 없음') && userResult.trim().length > 10) {
+            userPatternFound = true; // 0.4.6 perf #12 — adaptive cooldown 시그널
             fs.mkdirSync(BEHAVIOR_DIR, { recursive: true });
             const today = new Date().toISOString().split('T')[0];
             const trimmed = userResult.trim();
@@ -625,6 +716,7 @@ ${sanitizedSummary.slice(0, 4000)}
         completedAt: new Date().toISOString(),
         extractedSolutions: extractedSolutionsCount,
         promotedRules: promotedCount,
+        userPatternFound, // 0.4.6 perf #12 — adaptive cooldown 시그널
         noticeShown: false,
     }));
 }

package/dist/core/doctor.js

@@ -418,6 +418,15 @@ export async function runDoctor(opts = {}) {
         const report = pruneState({ dryRun: false });
         const mb = (report.bytesFreed / 1024 / 1024).toFixed(2);
         console.log(`  → Pruned ${report.pruned}/${report.scanned} files (${mb} MB freed, >${report.retentionDays}d old)`);
+        // 0.4.6 #14 — append-only jsonl 회전 (10MB cap)
+        try {
+            const { rotateAppendOnlyLogs } = await import('./state-gc.js');
+            const rot = rotateAppendOnlyLogs();
+            if (rot.rotated > 0) {
+                console.log(`  → Rotated ${rot.rotated}/${rot.scanned} append-only log(s): ${rot.sample.join(', ')}`);
+            }
+        }
+        catch { /* fail-open */ }
         // ADR-002 T4 — 90d 미주입 rule retire. pruneState 와 함께 "하루 한번 정돈" 의미 공유.
         try {
             const { runDailyT4Decay } = await import('./state-gc.js');

package/dist/core/harness.js

@@ -22,6 +22,52 @@ import { bootstrapV1Session, ensureV1Directories } from './v1-bootstrap.js';
 import { injectSettings } from './settings-injector.js';
 import { installAgents, installSlashCommands } from './installer.js';
 const log = createLogger('harness');
+/**
+ * 0.4.6 — Codex hooks fast staleness check + auto-reconcile.
+ *
+ * 매 codex 진입 시 hooks.json 의 forgen entry 가 현재 pkgRoot 와 일치하는지
+ * 검사. 불일치 또는 부재 시 planCodexInstall 을 silently 재실행.
+ *
+ * Staleness 판정: hooks.json 안의 첫 codex-adapter.js 경로가 현재 pkgRoot 의
+ * dist/host/codex-adapter.js 와 일치 여부.
+ *
+ * Performance: hot-path 회피를 위해 lazy import + 단순 string match. 정상
+ * 케이스에서 1ms 이내. 불일치 시 planCodexInstall (~50ms).
+ */
+async function ensureCodexHooksFresh(pkgRoot) {
+    const codexHome = process.env.CODEX_HOME ?? path.join(os.homedir(), '.codex');
+    const hooksPath = path.join(codexHome, 'hooks.json');
+    const expectedAdapterPath = path.join(pkgRoot, 'dist', 'host', 'codex-adapter.js');
+    let needsReinstall = false;
+    if (!fs.existsSync(hooksPath)) {
+        needsReinstall = true;
+        log.debug('codex hooks.json 부재 — install 필요');
+    }
+    else {
+        try {
+            const raw = fs.readFileSync(hooksPath, 'utf-8');
+            // 가장 간단한 staleness signal: 현재 pkgRoot 의 adapter 경로가 hooks.json 에 나타나는가?
+            if (!raw.includes(expectedAdapterPath)) {
+                needsReinstall = true;
+                log.debug(`codex hooks.json stale (expected ${expectedAdapterPath} 미발견)`);
+            }
+        }
+        catch (e) {
+            needsReinstall = true;
+            log.debug('codex hooks.json 읽기 실패 — reinstall', e);
+        }
+    }
+    if (!needsReinstall)
+        return;
+    try {
+        const { planCodexInstall } = await import('../host/install-codex.js');
+        planCodexInstall({ pkgRoot, registerMcp: true });
+        log.debug('codex hooks 자동 reconcile 완료');
+    }
+    catch (e) {
+        log.debug('codex hooks reconcile 실패', e);
+    }
+}
 /** forgen 패키지 루트 */
 function getPackageRoot() {
     return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
@@ -356,8 +402,21 @@ export async function prepareHarness(cwd, options = {}) {
             // 7. 슬래시 명령 설치
             installSlashCommands(cwd, pkgRoot);
         }
+        else if (runtime === 'codex') {
+            // 0.4.6 — Codex hooks 자동 reconcile-on-launch.
+            // 매 fgx --codex / forgen --runtime codex 호출 시 hooks.json 의 forgen entry 가
+            // 현재 pkgRoot 와 일치하는지 fast check. 불일치 (다른 머신/버전 install,
+            // pkg path 변경, 신규 설치) → silent reinstall.
+            // 사용자가 `forgen install codex` 를 명시 호출 안 해도 매번 정합성 보장.
+            try {
+                await ensureCodexHooksFresh(pkgRoot);
+            }
+            catch (e) {
+                log.debug('Codex hooks reconcile 실패 (fail-open)', e);
+            }
+        }
         else {
-            log.debug(`prepareHarness: runtime=${runtime} — Claude artifact prep skipped (Phase 3 handles Codex prep)`);
+            log.debug(`prepareHarness: runtime=${runtime} — artifact prep skipped`);
         }
         // 8. tmux 바인딩 등록
         if (inTmux) {

package/dist/core/notify.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Forgen — Desktop / webhook notification helper (ADR-008 §"테마 A 알림").
+ *
+ * 0.4.6 신설 — rate-limit auto-resume 이 sleep 끝나고 재기동될 때 사용자에게
+ * 알림을 보냄 (노트북 닫고 잘 때 끝났는지 알 수 있어야 함).
+ *
+ * 정책:
+ *  - macOS: osascript 'display notification'
+ *  - Linux: notify-send (있으면)
+ *  - Windows: 생략 (PowerShell BurntToast 의존성 회피)
+ *  - webhook: ~/.forgen/config.json 의 notifyWebhookUrl 설정 시 POST
+ *  - fail-open: 모든 실패는 silent log
+ */
+/**
+ * 통합 알림 진입점. desktop + webhook 둘 다 시도.
+ * 모든 실패는 silent — 호출 측 차단 안 함.
+ */
+export declare function sendNotification(title: string, body: string): void;

package/dist/core/notify.js

@@ -0,0 +1,93 @@
+/**
+ * Forgen — Desktop / webhook notification helper (ADR-008 §"테마 A 알림").
+ *
+ * 0.4.6 신설 — rate-limit auto-resume 이 sleep 끝나고 재기동될 때 사용자에게
+ * 알림을 보냄 (노트북 닫고 잘 때 끝났는지 알 수 있어야 함).
+ *
+ * 정책:
+ *  - macOS: osascript 'display notification'
+ *  - Linux: notify-send (있으면)
+ *  - Windows: 생략 (PowerShell BurntToast 의존성 회피)
+ *  - webhook: ~/.forgen/config.json 의 notifyWebhookUrl 설정 시 POST
+ *  - fail-open: 모든 실패는 silent log
+ */
+import { spawn } from 'node:child_process';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { FORGEN_HOME } from './paths.js';
+import { createLogger } from './logger.js';
+const log = createLogger('notify');
+function loadConfig() {
+    try {
+        const cfgPath = path.join(FORGEN_HOME, 'config.json');
+        if (!fs.existsSync(cfgPath))
+            return {};
+        return JSON.parse(fs.readFileSync(cfgPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function escapeForOsascript(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/** macOS native notification via osascript. silent fail. */
+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' });
+        child.unref();
+    }
+    catch (e) {
+        log.debug('osascript notification 실패', e);
+    }
+}
+/** Linux notify-send. silent fail (notify-send 미설치 OK). */
+function notifyLinux(title, body) {
+    try {
+        const child = spawn('notify-send', [title, body], { detached: true, stdio: 'ignore' });
+        child.unref();
+    }
+    catch (e) {
+        log.debug('notify-send 실패', e);
+    }
+}
+/** webhook POST (slack/discord 호환). silent fail. */
+async function notifyWebhook(url, title, body) {
+    try {
+        // Slack / Discord 호환 — text 필드 우선, fallback 으로 content
+        const payload = JSON.stringify({
+            text: `*${title}*\n${body}`,
+            content: `**${title}**\n${body}`, // Discord
+        });
+        await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: payload,
+        });
+    }
+    catch (e) {
+        log.debug('webhook notify 실패', e);
+    }
+}
+/**
+ * 통합 알림 진입점. desktop + webhook 둘 다 시도.
+ * 모든 실패는 silent — 호출 측 차단 안 함.
+ */
+export function sendNotification(title, body) {
+    const cfg = loadConfig();
+    const desktopEnabled = cfg.notifyDesktop !== false; // default true
+    if (desktopEnabled) {
+        const platform = os.platform();
+        if (platform === 'darwin')
+            notifyDarwin(title, body);
+        else if (platform === 'linux')
+            notifyLinux(title, body);
+        // win32: 생략
+    }
+    if (cfg.notifyWebhookUrl) {
+        // fire-and-forget — await 하지 않음 (caller 차단 방지)
+        void notifyWebhook(cfg.notifyWebhookUrl, title, body);
+    }
+}

package/dist/core/settings-injector.js

@@ -43,12 +43,18 @@ function readSettingsWithBackup() {
     }
     return settings;
 }
-/** Apply forgen statusLine only if user hasn't set a custom one. */
+/** Apply forgen statusLine only if user hasn't set a custom one.
+ *  Migration: 'forgen me' → 'forgen statusline' (multi-line dump → compact HUD). */
 function applyStatusLine(settings) {
     const existing = settings.statusLine;
+    // 기존에 'forgen me'로 주입된 경우 → 'forgen statusline'으로 자동 마이그레이션
+    if (existing?.command === 'forgen me') {
+        settings.statusLine = { type: 'command', command: 'forgen statusline' };
+        return;
+    }
     const isForgenOwned = !existing || !existing.command || existing.command.startsWith('forgen');
     if (isForgenOwned) {
-        settings.statusLine = { type: 'command', command: 'forgen me' };
+        settings.statusLine = { type: 'command', command: 'forgen statusline' };
     }
 }
 /** Check if a settings.json hook entry was installed by forgen. */

package/dist/core/spawn.d.ts

@@ -2,8 +2,19 @@ import type { V1HarnessContext } from './harness.js';
 import type { RuntimeHost } from './types.js';
 /** Claude Code를 하네스 환경으로 실행. exit code를 반환. */
 export declare function spawnClaude(args: string[], context: V1HarnessContext, runtime?: RuntimeHost): Promise<number>;
+declare const MAX_RESUMES = 3;
 /**
- * 토큰 한도 도달 시 자동 재시작을 지원하는 claude 실행 래퍼.
- * context-guard가 pending-resume.json 마커를 생성하면 쿨다운 후 재시작.
+ * Exponential backoff for rate-limit when resetAt 파싱 실패.
+ * 1m → 5m → 15m → 30m → 1h → 2h cap. 합 ≤ 6h.
+ */
+export declare function rateLimitBackoffMs(attempt: number): number;
+/**
+ * 토큰 한도 / API rate-limit 도달 시 자동 재시작을 지원하는 claude 실행 래퍼.
+ * context-guard가 pending-resume.json 마커를 생성하면 reason 별 정책으로 처리.
+ *
+ * - reason='token-limit': 30s 쿨다운, MAX_RESUMES_TOKEN=3
+ * - reason='rate-limit': resetAt 정밀 sleep (+60s 버퍼) 또는 exponential backoff,
+ *                        MAX_RESUMES_RATE=10, hard cap 6h
  */
 export declare function spawnClaudeWithResume(args: string[], context: V1HarnessContext, contextFactory: () => Promise<V1HarnessContext>, runtime?: RuntimeHost): Promise<void>;
+export { MAX_RESUMES };