@wooojin/forgen 0.4.7 → 0.4.9

package/dist/engine/compound-extractor.js

@@ -21,6 +21,7 @@ import { execFileSync } from 'node:child_process';
 import { execHost } from '../host/exec-host.js';
 import { serializeSolutionV3, DEFAULT_EVIDENCE, extractTags } from './solution-format.js';
 import { createLogger } from '../core/logger.js';
+import { emitSolutionEvent } from '../core/observability-store.js';
 const log = createLogger('compound-extractor');
 import { CLAUDE_DIR, ME_SOLUTIONS, STATE_DIR } from '../core/paths.js';
 import { atomicWriteJSON, atomicWriteText } from '../hooks/shared/atomic-write.js';
@@ -557,7 +558,7 @@ function findCommonPrefix(strings) {
     return prefix.replace(/-$/, '');
 }
 /** Save an extracted solution as experiment */
-function saveExtractedSolution(sol, sessionId) {
+function saveExtractedSolution(sol, _sessionId) {
     const today = new Date().toISOString().split('T')[0];
     const slugName = sol.name.toLowerCase()
         .replace(/[^a-z0-9가-힣\s-]/g, '')
@@ -845,6 +846,42 @@ export async function runExtraction(cwd, sessionId) {
     }
     return result;
 }
+/**
+ * Observability P2: 새 솔루션 본문/supersedes 에서 기존 솔루션 참조 감지 → acted_on emit.
+ * fail-open.
+ */
+function emitCompoundExtractActedOn(sessionId, newSolutionName, newContent, newSupersedes) {
+    try {
+        if (!fs.existsSync(ME_SOLUTIONS))
+            return;
+        const bodyLower = newContent.toLowerCase();
+        const supersedes = newSupersedes ?? '';
+        const files = fs.readdirSync(ME_SOLUTIONS).filter(f => f.endsWith('.md'));
+        for (const file of files) {
+            const existingName = path.basename(file, '.md');
+            if (existingName === newSolutionName)
+                continue;
+            const referenced = (supersedes && existingName === supersedes)
+                || bodyLower.includes(existingName.toLowerCase());
+            if (!referenced)
+                continue;
+            emitSolutionEvent({
+                sessionId,
+                solutionId: existingName,
+                eventType: 'acted_on',
+                signalSource: 'compound-extract',
+                signalScore: 0.20,
+                meta: {
+                    new_solution: newSolutionName,
+                    via: (supersedes && existingName === supersedes) ? 'supersedes' : 'body-mention',
+                },
+            });
+        }
+    }
+    catch (e) {
+        log.debug('emitCompoundExtractActedOn 실패', e);
+    }
+}
 /** Process LLM extraction results (called after LLM returns) */
 export function processExtractionResults(rawJson, sessionId) {
     const saved = [];
@@ -882,6 +919,8 @@ export function processExtractionResults(rawJson, sessionId) {
         const savedName = saveExtractedSolution(sol, sessionId);
         if (savedName) {
             saved.push(savedName);
+            // Observability P2: compound-extract acted_on signal
+            emitCompoundExtractActedOn(sessionId, savedName, sol.content, null);
         }
         else {
             skipped.push(`${sol.name}: 파일 이미 존재`);

package/dist/engine/compound-loop.js

@@ -332,6 +332,12 @@ export async function handleCompound(args) {
         rollbackSolutions(since, { dryRun });
         return;
     }
+    // --- retire command (P3: dead 솔루션 archive) ---
+    if (args.includes('retire') || args.includes('--retire')) {
+        const { handleCompoundRetire } = await import('./compound-retire.js');
+        await handleCompoundRetire(args);
+        return;
+    }
     // --- explicit interactive command ---
     if (args.includes('interactive') || args.includes('--interactive')) {
         await interactiveCompound(cwd, scope);

package/dist/engine/compound-retire.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Forgen — Compound Retire (P3)
+ *
+ * `forgen compound retire [--dry-run] [--apply]`
+ *
+ * dead 분류 솔루션을 ~/ .forgen/lab/archived/<id>.md 로 이동.
+ * 기본은 dry-run (목록만 출력). --apply 시 사용자 확인 후 이동.
+ */
+export interface RetireResult {
+    retired: string[];
+    skipped: string[];
+    dryRun: boolean;
+}
+/** dead 솔루션을 lab/archived/ 로 이동 */
+export declare function retireDeadSolutions(opts: {
+    dryRun: boolean;
+    yes?: boolean;
+}): Promise<RetireResult>;
+/** CLI 핸들러: forgen compound retire */
+export declare function handleCompoundRetire(args: string[]): Promise<void>;

package/dist/engine/compound-retire.js

@@ -0,0 +1,85 @@
+/**
+ * Forgen — Compound Retire (P3)
+ *
+ * `forgen compound retire [--dry-run] [--apply]`
+ *
+ * dead 분류 솔루션을 ~/ .forgen/lab/archived/<id>.md 로 이동.
+ * 기본은 dry-run (목록만 출력). --apply 시 사용자 확인 후 이동.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as readline from 'node:readline';
+import { ME_SOLUTIONS, ARCHIVED_DIR } from '../core/paths.js';
+import { classifySolutions } from '../core/lifecycle-classifier.js';
+function promptConfirm(question) {
+    return new Promise(resolve => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(question, answer => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes');
+        });
+    });
+}
+/** dead 솔루션을 lab/archived/ 로 이동 */
+export async function retireDeadSolutions(opts) {
+    const classified = classifySolutions();
+    const dead = classified.filter(c => c.lifecycle === 'dead');
+    const retired = [];
+    const skipped = [];
+    if (dead.length === 0) {
+        return { retired: [], skipped: [], dryRun: opts.dryRun };
+    }
+    // dry-run or apply 출력
+    console.log(`\n  Dead solutions (${dead.length}):\n`);
+    for (const d of dead) {
+        const dest = path.join(ARCHIVED_DIR, `${d.solutionId}.md`);
+        console.log(`    ${d.solutionId}`);
+        console.log(`      matched_180d=${d.matched_180d}  age=${d.ageDays}d`);
+        console.log(`      → ${dest}`);
+    }
+    console.log();
+    if (opts.dryRun) {
+        console.log('  [dry-run] 파일 이동 없음. --apply 로 실행하세요.\n');
+        return { retired: dead.map(d => d.solutionId), skipped: [], dryRun: true };
+    }
+    // apply — 확인 프롬프트
+    if (!opts.yes) {
+        const ok = await promptConfirm(`  ${dead.length}개 솔루션을 archived 로 이동합니다. 계속하시겠습니까? (y/N) `);
+        if (!ok) {
+            console.log('  취소되었습니다.\n');
+            return { retired: [], skipped: dead.map(d => d.solutionId), dryRun: false };
+        }
+    }
+    // mkdir + rename (fail-stop: 오류 시 즉시 throw)
+    fs.mkdirSync(ARCHIVED_DIR, { recursive: true });
+    for (const d of dead) {
+        const src = path.join(ME_SOLUTIONS, `${d.solutionId}.md`);
+        const dest = path.join(ARCHIVED_DIR, `${d.solutionId}.md`);
+        // 이미 archived 인 경우 skip
+        if (fs.existsSync(dest)) {
+            skipped.push(d.solutionId);
+            continue;
+        }
+        // src 없으면 skip
+        if (!fs.existsSync(src)) {
+            skipped.push(d.solutionId);
+            continue;
+        }
+        // fail-stop: rename 실패 시 throw (데이터 이동 정확성 우선)
+        fs.renameSync(src, dest);
+        retired.push(d.solutionId);
+    }
+    console.log(`  ✓ ${retired.length}개 이동 완료`);
+    if (skipped.length > 0) {
+        console.log(`  ○ ${skipped.length}개 skip (이미 archived 또는 파일 없음)`);
+    }
+    console.log();
+    return { retired, skipped, dryRun: false };
+}
+/** CLI 핸들러: forgen compound retire */
+export async function handleCompoundRetire(args) {
+    const apply = args.includes('--apply');
+    const yes = args.includes('--yes');
+    const dryRun = !apply;
+    await retireDeadSolutions({ dryRun, yes });
+}

package/dist/engine/learn-cli.js

@@ -136,7 +136,7 @@ function runFitness(args) {
     console.log(`    ${'name'.padEnd(48)} ${'state'.padEnd(14)} ${'inj'.padStart(4)}  ${'acc/cor/err'.padStart(11)}  ${'fit'.padStart(6)}`);
     console.log(`    ${'-'.repeat(48)} ${'-'.repeat(14)} ${'-'.repeat(4)}  ${'-'.repeat(11)}  ${'-'.repeat(6)}`);
     for (const r of records) {
-        const name = r.solution.length > 47 ? r.solution.slice(0, 45) + '..' : r.solution;
+        const name = r.solution.length > 47 ? `${r.solution.slice(0, 45)}..` : r.solution;
         const acr = `${r.accepted}/${r.corrected}/${r.errored}`;
         console.log(`    ${name.padEnd(48)} ${r.state.padEnd(14)} ${String(r.injected).padStart(4)}  ${acr.padStart(11)}  ${r.fitness.toFixed(2).padStart(6)}`);
     }
@@ -222,7 +222,7 @@ function runEvolvePromote(candidateNameOrList) {
     }
     const result = promoteCandidate(candidateNameOrList);
     if (result.ok) {
-        console.log(`\n  ✓ Promoted: ${path.basename(result.dest)}`);
+        console.log(`\n  ✓ Promoted: ${result.dest ? path.basename(result.dest) : '(unknown)'}`);
         console.log(`    from: ${result.source}`);
         console.log(`    to:   ${result.dest}`);
         console.log(`    Cold-start bonus active until 5 injections accumulate (auto-promotes to verified).\n`);

package/dist/engine/lifecycle/bypass-detector.js

@@ -51,9 +51,10 @@ function extractParenthesizedExamples(p) {
     const out = [];
     // Match (...) groups; multiple groups in policy are uncommon but supported
     const re = /\(([^)]+)\)/g;
-    let m;
-    while ((m = re.exec(p))) {
+    let m = re.exec(p);
+    while (m !== null) {
         const inside = m[1];
+        m = re.exec(p);
         // Skip if it looks like a path (contains "/" before any obvious separator commitment)
         if (/[a-zA-Z]+\/[a-zA-Z]/.test(inside))
             continue;

package/dist/engine/lifecycle/meta-reclassifier.js

@@ -294,7 +294,7 @@ export function appendLifecycleEvents(events, now = Date.now()) {
             }
         }
         catch { /* missing → no rotate */ }
-        const body = events.map((e) => JSON.stringify(e)).join('\n') + '\n';
+        const body = `${events.map((e) => JSON.stringify(e)).join('\n')}\n`;
         fs.appendFileSync(logPath, body);
     }
     catch (e) {

package/dist/engine/lifecycle/signals.js

@@ -62,7 +62,7 @@ export function recordViolation(entry) {
         fs.mkdirSync(ENFORCEMENT_DIR, { recursive: true });
         rotateIfBig(VIOLATIONS_PATH);
         const full = { at: new Date().toISOString(), ...entry };
-        fs.appendFileSync(VIOLATIONS_PATH, JSON.stringify(full) + '\n');
+        fs.appendFileSync(VIOLATIONS_PATH, `${JSON.stringify(full)}\n`);
     }
     catch (e) {
         // best-effort, 실패 시 debug 로그 (silent swallow 방지)
@@ -76,7 +76,7 @@ export function recordBypass(entry) {
         fs.mkdirSync(ENFORCEMENT_DIR, { recursive: true });
         rotateIfBig(BYPASS_PATH);
         const full = { at: new Date().toISOString(), ...entry };
-        fs.appendFileSync(BYPASS_PATH, JSON.stringify(full) + '\n');
+        fs.appendFileSync(BYPASS_PATH, `${JSON.stringify(full)}\n`);
     }
     catch (e) {
         if (process.env.FORGEN_DEBUG_SIGNALS === '1') {

package/dist/engine/lifecycle/trigger-t1-correction.js

@@ -39,7 +39,7 @@ function matchesRule(evidence, rule) {
         .toLowerCase();
     return keyTokens.some((t) => {
         const tokLower = t.toLowerCase();
-        return summaryLower.includes(tokLower) || (targetToken && targetToken.includes(tokLower));
+        return summaryLower.includes(tokLower) || (targetToken?.includes(tokLower));
     });
 }
 export function detect(input) {

package/dist/engine/solution-candidate.js

@@ -100,7 +100,7 @@ export function rollbackSince(epochMs) {
                 continue;
             try {
                 fs.mkdirSync(archiveDir, { recursive: true });
-                const destName = path.basename(dir) + '__' + file;
+                const destName = `${path.basename(dir)}__${file}`;
                 fs.renameSync(filePath, path.join(archiveDir, destName));
                 archived.push(filePath);
             }

package/dist/engine/solution-outcomes.js

@@ -30,7 +30,7 @@ function writePending(sessionId, state) {
 }
 function appendOutcome(event) {
     fs.mkdirSync(OUTCOMES_DIR, { recursive: true });
-    fs.appendFileSync(outcomesPath(event.session_id), JSON.stringify(event) + '\n');
+    fs.appendFileSync(outcomesPath(event.session_id), `${JSON.stringify(event)}\n`);
 }
 /**
  * Run a read-modify-write pending-state mutation under a file lock

package/dist/engine/solution-quarantine.js

@@ -49,7 +49,7 @@ export function recordQuarantine(filePath, errors) {
             at: new Date().toISOString(),
             errors,
         };
-        fs.appendFileSync(SOLUTION_QUARANTINE_PATH, JSON.stringify(entry) + '\n');
+        fs.appendFileSync(SOLUTION_QUARANTINE_PATH, `${JSON.stringify(entry)}\n`);
     }
     catch (e) {
         log.debug(`quarantine write failed: ${e instanceof Error ? e.message : String(e)}`);

package/dist/engine/solution-weakness.js

@@ -97,14 +97,20 @@ function findConflictClusters(rows, fitnessByName) {
     const underperformers = rows.filter((r) => fitnessByName.get(r.name)?.state === 'underperform');
     const clusters = [];
     for (const ch of champions) {
+        const chFitness = fitnessByName.get(ch.name)?.fitness;
+        if (chFitness === undefined)
+            continue;
         for (const up of underperformers) {
+            const upFitness = fitnessByName.get(up.name)?.fitness;
+            if (upFitness === undefined)
+                continue;
             const shared = ch.tags.filter((t) => up.tags.includes(t));
             if (shared.length < 2)
                 continue;
             clusters.push({
                 shared_tags: shared,
-                champion: { name: ch.name, fitness: fitnessByName.get(ch.name).fitness },
-                underperform: { name: up.name, fitness: fitnessByName.get(up.name).fitness },
+                champion: { name: ch.name, fitness: chFitness },
+                underperform: { name: up.name, fitness: upFitness },
             });
         }
     }

package/dist/forge/cli.js

@@ -39,7 +39,7 @@ function handleShowProfile() {
         console.log('\n  No v1 profile found. Run `forgen forge` or `forgen onboarding`.\n');
         return;
     }
-    console.log('\n' + renderProfile(profile) + '\n');
+    console.log(`\n${renderProfile(profile)}\n`);
 }
 function handleExport() {
     const profile = loadProfile();

package/dist/hooks/context-guard.js

@@ -29,7 +29,7 @@ const PROMPT_HISTORY_TRUNCATE = 1024; // ADR-008: 1KB cap per entry
 const RATE_LIMIT_MISSES_PATH = path.join(STATE_DIR, 'rate-limit-misses.jsonl');
 // ADR-008: detection regex 분리. token-limit 은 context window, rate-limit 은 API quota.
 export const TOKEN_LIMIT_REGEX = /context.*limit|token.*limit|conversation.*too.*long/i;
-export const RATE_LIMIT_REGEX = /rate.?limit|5.?hour.*limit|weekly.*limit|usage.*limit|quota.*exceeded/i;
+export const RATE_LIMIT_REGEX = /rate.?limit|5.?hour.*limit|weekly.*limit|usage.*limit|quota.*exceeded|out of (?:extra |free )?usage|usage cap|monthly limit reached?/i;
 /**
  * Best-effort reset 시각 파서 (ADR-008 §2).
  *
@@ -64,6 +64,30 @@ export function parseRateLimitResetAt(msg, now = Date.now()) {
         if (sec > 0)
             return new Date(now + sec * 1000).toISOString();
     }
+    // Pattern 5: "resets <H>:<MM><am|pm>" (12h, optional "at", optional TZ label in parens)
+    // Pattern 1보다 앞에 위치: "resets at 4:20 pm" 에서 Pattern 1이 am/pm 없이 잡으면
+    // 24h 로 오변환되므로 am/pm 있는 경우를 먼저 처리.
+    // 예: "resets 4:20pm", "resets 4:20pm (Asia/Seoul)", "resets at 4:20 pm"
+    const ampm = msg.match(/resets?\s+(?:at\s+)?(\d{1,2}):(\d{2})\s*(am|pm)/i);
+    if (ampm) {
+        let h = parseInt(ampm[1], 10);
+        const m = parseInt(ampm[2], 10);
+        const meridiem = ampm[3].toLowerCase();
+        if (h >= 1 && h <= 12 && m >= 0 && m <= 59) {
+            // 12h → 24h 변환: 12am=0, 12pm=12, 1-11am=1-11, 1-11pm=13-23
+            if (meridiem === 'am') {
+                h = h === 12 ? 0 : h;
+            }
+            else {
+                h = h === 12 ? 12 : h + 12;
+            }
+            const d = new Date(now);
+            d.setUTCHours(h, m, 0, 0);
+            if (d.getTime() <= now)
+                d.setUTCDate(d.getUTCDate() + 1);
+            return d.toISOString();
+        }
+    }
     // Pattern 1: "Resets at HH:MM(:SS)? TZ" — TZ 미지원 (UTC 가정)
     const hhmm = msg.match(/(?:reset|retry|available)s?\s+at\s+(\d{1,2}):(\d{2})(?::(\d{2}))?\s*(UTC|GMT|PST|PDT|EST|EDT|KST|JST)?/i);
     if (hhmm) {

package/dist/hooks/keyword-detector.js

@@ -192,7 +192,7 @@ async function main() {
             return;
         }
         const match = detectKeyword(input.prompt);
-        const sessionId = input.session_id ?? 'unknown';
+        const _sessionId = input.session_id ?? 'unknown';
         // v1: regex 기반 prompt 학습 제거. Evidence 기반으로 전환됨.
         if (!match) {
             console.log(approve());

package/dist/hooks/post-tool-use.js

@@ -22,6 +22,9 @@ import { recordHookTiming } from './shared/hook-timing.js';
 import { createDriftState, evaluateDrift } from '../core/drift-score.js';
 import { appendImplicitFeedback } from '../store/implicit-feedback-store.js';
 import { recordToolCall } from '../core/usage-telemetry.js';
+import { emitSolutionEvent, querySurfacedWithin } from '../core/observability-store.js';
+import { parseSolutionV3 } from '../engine/solution-format.js';
+import { ME_SOLUTIONS } from '../core/paths.js';
 const RECENT_TOOL_NAMES_WINDOW = 20;
 /** Lightweight hash for content comparison (not cryptographic) */
 function simpleHash(content) {
@@ -338,6 +341,51 @@ async function main() {
         catch (e) {
             log.debug('success hint generation 실패', e);
         }
+        // 8. Observability P2: tool-pattern acted_on signal
+        try {
+            const recentSurfaces = querySurfacedWithin(sessionId, 5);
+            if (recentSurfaces.length > 0 && toolName) {
+                const toolNameLower = toolName.toLowerCase();
+                const seen = new Set();
+                for (const surf of recentSurfaces) {
+                    if (seen.has(surf.solutionId))
+                        continue;
+                    seen.add(surf.solutionId);
+                    const filePath = path.join(ME_SOLUTIONS, `${surf.solutionId}.md`);
+                    if (!fs.existsSync(filePath))
+                        continue;
+                    let raw;
+                    try {
+                        raw = fs.readFileSync(filePath, 'utf-8');
+                    }
+                    catch {
+                        continue;
+                    }
+                    const sol = parseSolutionV3(raw);
+                    if (!sol)
+                        continue;
+                    const tags = sol.frontmatter.tags ?? [];
+                    const identifiers = sol.frontmatter.identifiers ?? [];
+                    if (tags.length === 0 && identifiers.length === 0)
+                        continue;
+                    const hit = tags.some(t => toolNameLower.includes(t.toLowerCase()))
+                        || identifiers.some(id => toolNameLower.includes(id.toLowerCase()));
+                    if (!hit)
+                        continue;
+                    emitSolutionEvent({
+                        sessionId,
+                        solutionId: surf.solutionId,
+                        eventType: 'acted_on',
+                        signalSource: 'tool-pattern',
+                        signalScore: 0.30,
+                        meta: { tool: toolName, surface_ts: surf.ts },
+                    });
+                }
+            }
+        }
+        catch (e) {
+            log.debug('tool-pattern acted_on emit 실패', e);
+        }
         saveModifiedFiles(modState);
         if (messages.length > 0) {
             console.log(approveWithWarning(messages.join('\n')));

package/dist/hooks/secret-filter.js

@@ -34,10 +34,10 @@ export function redactSecrets(text) {
     let out = text;
     for (const sp of SECRET_PATTERNS) {
         // regex 복제 (global flag 없이 repeated test 되는 경우 lastIndex 안전)
-        const re = new RegExp(sp.pattern.source, (sp.pattern.flags.includes('g') ? sp.pattern.flags : sp.pattern.flags + 'g'));
+        const re = new RegExp(sp.pattern.source, (sp.pattern.flags.includes('g') ? sp.pattern.flags : `${sp.pattern.flags}g`));
         if (re.test(out)) {
             hits.push(sp);
-            const re2 = new RegExp(sp.pattern.source, (sp.pattern.flags.includes('g') ? sp.pattern.flags : sp.pattern.flags + 'g'));
+            const re2 = new RegExp(sp.pattern.source, (sp.pattern.flags.includes('g') ? sp.pattern.flags : `${sp.pattern.flags}g`));
             out = out.replace(re2, `[REDACTED:${sp.name}]`);
         }
     }

package/dist/hooks/shared/hook-response.js

@@ -146,7 +146,7 @@ export function failOpenWithTracking(hookName, err) {
             }
         }
         const entry = JSON.stringify(payload);
-        fs.appendFileSync(logPath, entry + '\n');
+        fs.appendFileSync(logPath, `${entry}\n`);
     }
     catch { /* fail-open: tracking itself must not throw */ }
     return JSON.stringify({ continue: true });

package/dist/hooks/shared/hook-timing.js

@@ -19,7 +19,7 @@ export function recordHookTiming(hookName, durationMs, event) {
     try {
         fs.mkdirSync(STATE_DIR, { recursive: true });
         const entry = JSON.stringify({ hook: hookName, ms: durationMs, event, at: Date.now() });
-        fs.appendFileSync(TIMING_LOG, entry + '\n');
+        fs.appendFileSync(TIMING_LOG, `${entry}\n`);
         // Rotate if too large — size-gated (statSync only, skip read/write 대부분의 호출)
         try {
             const size = fs.statSync(TIMING_LOG).size;
@@ -28,7 +28,7 @@ export function recordHookTiming(hookName, durationMs, event) {
             const content = fs.readFileSync(TIMING_LOG, 'utf-8');
             const lines = content.trim().split('\n');
             if (lines.length > MAX_LINES) {
-                fs.writeFileSync(TIMING_LOG, lines.slice(-MAX_LINES).join('\n') + '\n');
+                fs.writeFileSync(TIMING_LOG, `${lines.slice(-MAX_LINES).join('\n')}\n`);
             }
         }
         catch { /* skip rotation on error */ }
@@ -52,7 +52,7 @@ export function getTimingStats() {
         for (const e of entries) {
             if (!byHook.has(e.hook))
                 byHook.set(e.hook, []);
-            byHook.get(e.hook).push(e.ms);
+            byHook.get(e.hook)?.push(e.ms);
         }
         const stats = [];
         for (const [hook, times] of byHook) {

package/dist/hooks/solution-injector.js

@@ -30,6 +30,9 @@ import { STATE_DIR } from '../core/paths.js';
 import { recordHookTiming } from './shared/hook-timing.js';
 import { appendPending, flushAccept } from '../engine/solution-outcomes.js';
 import { appendImplicitFeedback } from '../store/implicit-feedback-store.js';
+import { emitSolutionEvent, querySurfacedWithin } from '../core/observability-store.js';
+import { parseSolutionV3 } from '../engine/solution-format.js';
+import { ME_SOLUTIONS } from '../core/paths.js';
 const MAX_SOLUTIONS_PER_SESSION = 10;
 /**
  * Minimum relevance thresholds by fitness state (2026-04-21 gate sweep).
@@ -252,6 +255,56 @@ function backfillCacheTagsOnDisk(cachePath, allMatched) {
         }
     }
 }
+/**
+ * 직전 5분 내 surfaced 된 솔루션이 현재 프롬프트와 키워드 매칭 시 acted_on emit.
+ * tags/identifiers 가 없는 솔루션은 skip. fail-open.
+ */
+async function detectActOnFromPriorSurface(sessionId, promptLower) {
+    try {
+        const recentSurfaces = querySurfacedWithin(sessionId, 5);
+        if (recentSurfaces.length === 0)
+            return;
+        const seen = new Set();
+        for (const surf of recentSurfaces) {
+            if (seen.has(surf.solutionId))
+                continue;
+            seen.add(surf.solutionId);
+            // 솔루션 파일 로드 (ME_SOLUTIONS 기준)
+            const filePath = path.join(ME_SOLUTIONS, `${surf.solutionId}.md`);
+            if (!fs.existsSync(filePath))
+                continue;
+            let raw;
+            try {
+                raw = fs.readFileSync(filePath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const sol = parseSolutionV3(raw);
+            if (!sol)
+                continue;
+            const tags = sol.frontmatter.tags ?? [];
+            const identifiers = sol.frontmatter.identifiers ?? [];
+            if (tags.length === 0 && identifiers.length === 0)
+                continue;
+            const hit = tags.some(t => promptLower.includes(t.toLowerCase()))
+                || identifiers.some(id => promptLower.includes(id.toLowerCase()));
+            if (!hit)
+                continue;
+            emitSolutionEvent({
+                sessionId,
+                solutionId: surf.solutionId,
+                eventType: 'acted_on',
+                signalSource: 'prompt-keyword',
+                signalScore: 0.20,
+                meta: { surface_ts: surf.ts },
+            });
+        }
+    }
+    catch (e) {
+        log.debug('detectActOnFromPriorSurface 실패', e);
+    }
+}
 async function main() {
     const _hookStart = Date.now();
     try {
@@ -265,6 +318,8 @@ async function main() {
             return;
         }
         const sessionId = input.session_id ?? 'default';
+        // Observability P2: 직전 surfaced 솔루션과 현재 프롬프트 키워드 매칭 → acted_on emit
+        await detectActOnFromPriorSurface(sessionId, input.prompt.toLowerCase());
         // v1: 교정 감지 → correction-record 호출 유도 hint
         const correctionPatterns = /하지\s*마|그렇게\s*말고|앞으로는|이렇게\s*해|stop\s+doing|don'?t\s+do|always\s+do|never\s+do|아니\s*그게\s*아니라/i;
         if (correctionPatterns.test(input.prompt)) {
@@ -294,6 +349,25 @@ async function main() {
         // 다시 매칭되면 그 정보로 cache의 missing tags를 채울 수 있다.
         // matches는 새 주입 후보 (이미 injected는 제외).
         const allMatched = matchSolutions(input.prompt, scope, cwd);
+        // Observability P1: matched emit — top-5 후보 각각 기록
+        try {
+            for (const candidate of allMatched.slice(0, 5)) {
+                emitSolutionEvent({
+                    sessionId,
+                    solutionId: candidate.name,
+                    eventType: 'matched',
+                    signalSource: 'matcher',
+                    signalScore: candidate.relevance,
+                    meta: {
+                        matchedTags: candidate.matchedTags,
+                        matchedIdentifiers: candidate.matchedIdentifiers,
+                    },
+                });
+            }
+        }
+        catch (e) {
+            log.debug('matched emit 실패', e);
+        }
         const matches = allMatched.filter(m => !injected.has(m.name));
         // T3: emit a ranking-decision record for offline analysis. Fail-open —
         // the logger swallows any error so this never blocks hook approval.
@@ -409,7 +483,7 @@ async function main() {
                         .filter(l => l.length > 0);
                     contentSnippet = lines.slice(0, 3).join('\n');
                     if (contentSnippet.length > SUMMARY_MAX_CHARS) {
-                        contentSnippet = contentSnippet.slice(0, SUMMARY_MAX_CHARS - 3) + '...';
+                        contentSnippet = `${contentSnippet.slice(0, SUMMARY_MAX_CHARS - 3)}...`;
                     }
                 }
             }
@@ -566,6 +640,25 @@ async function main() {
         catch (e) {
             log.debug('recommendation_surfaced emit 실패', e);
         }
+        // Observability P1: surfaced emit — approveWithContext 직전 effectiveToInject 각각 기록
+        try {
+            for (const sol of effectiveToInject) {
+                emitSolutionEvent({
+                    sessionId,
+                    solutionId: sol.name,
+                    eventType: 'surfaced',
+                    signalSource: 'hook-prepend',
+                    signalScore: sol.relevance,
+                    meta: {
+                        surfaceChars: fullInjection.length,
+                        injectionMode: 'context-prepend',
+                    },
+                });
+            }
+        }
+        catch (e) {
+            log.debug('surfaced emit 실패', e);
+        }
         // H1: 사용자 UI 에 recall hit 1줄 노출. additionalContext 는 모델 전용이라
         // v0.4.0 에서 8,000+ 주입이 발생했는데도 사용자는 0건을 봤다. systemMessage
         // 로 "N개 솔루션 참조" 를 surface → 사용자가 어떤 축적 지식이 붙었는지 인식.

package/dist/hooks/stop-guard.js

@@ -370,14 +370,14 @@ export function acknowledgeSessionBlocks(sessionId) {
             try {
                 fs.mkdirSync(path.dirname(ACK_LOG), { recursive: true });
                 rotateIfBig(ACK_LOG);
-                fs.appendFileSync(ACK_LOG, JSON.stringify({
+                fs.appendFileSync(ACK_LOG, `${JSON.stringify({
                     at: now,
                     session_id: state.sessionId,
                     rule_id: state.ruleId,
                     block_count: state.count,
                     first_block_at: state.firstBlockAt,
                     last_block_at: state.lastBlockAt,
-                }) + '\n');
+                })}\n`);
                 acked += 1;
             }
             catch { /* append failure: still try cleanup */ }
@@ -396,7 +396,7 @@ export function logDriftEvent(event) {
     try {
         fs.mkdirSync(path.dirname(DRIFT_LOG), { recursive: true });
         rotateIfBig(DRIFT_LOG);
-        fs.appendFileSync(DRIFT_LOG, JSON.stringify({ at: new Date().toISOString(), ...event }) + '\n');
+        fs.appendFileSync(DRIFT_LOG, `${JSON.stringify({ at: new Date().toISOString(), ...event })}\n`);
     }
     catch {
         // best-effort