@wooojin/forgen 0.4.13 → 0.5.0

package/dist/mcp/tools.js

@@ -278,11 +278,24 @@ export function registerTools(server) {
         try {
             // v1 session_id를 환경변수에서 가져옴 (하네스가 설정)
             const effectiveSessionId = session_id || process.env.FORGEN_SESSION_ID || 'unknown';
+            // W2-5 (private 태그): 교정 텍스트에서 <private>…</private>/forgen:private 범위
+            // 제거 후 저장. 교정 message 가 통째로 private 이면 저장 자체를 skip (학습
+            // 코퍼스에 남기지 않겠다는 사용자 의도). 조용히 하지 않고 공지한다.
+            const { stripPrivate, isFullyPrivate } = await import('../engine/private-filter.js');
+            if (isFullyPrivate(message)) {
+                return { content: [{ type: 'text', text: '✓ [forgen] correction skipped — message was fully <private> (not stored).' }] };
+            }
+            const cleanMessage = stripPrivate(message).cleaned;
+            const strippedTarget = stripPrivate(target);
+            const cleanTarget = strippedTarget.cleaned;
+            const privateNote = (strippedTarget.hadPrivate || cleanMessage !== message)
+                ? '\n(참고: <private> 범위는 기록에서 제외됨)'
+                : '';
             const result = processCorrection({
                 session_id: effectiveSessionId,
                 kind: kind,
-                message,
-                target,
+                message: cleanMessage,
+                target: cleanTarget,
                 axis_hint: axis_hint,
             });
             // Outcome tracking (Phase 1): attribute this correction to any
@@ -320,7 +333,7 @@ export function registerTools(server) {
             return {
                 content: [{
                         type: 'text',
-                        text: lines.join('\n'),
+                        text: lines.join('\n') + privateNote,
                     }],
             };
         }
@@ -343,7 +356,7 @@ export function registerTools(server) {
             return {
                 content: [{
                         type: 'text',
-                        text: 'No profile configured. Run forgen onboarding.',
+                        text: 'No profile configured. Run forgen forge --onboarding.',
                     }],
             };
         }

package/dist/store/evidence-store.d.ts

@@ -5,6 +5,7 @@
  * Authoritative schema: docs/plans/2026-04-03-forgen-data-model-storage-spec.md §4
  */
 import type { Evidence, EvidenceType } from './types.js';
+import { type HostId } from '../core/trust-layer-intent.js';
 export declare function createEvidence(params: {
     type: EvidenceType;
     session_id: string;
@@ -14,7 +15,7 @@ export declare function createEvidence(params: {
     candidate_rule_refs?: string[];
     confidence: number;
     raw_payload?: Record<string, unknown>;
-    host?: 'claude' | 'codex';
+    host?: HostId;
 }): Evidence;
 export declare function saveEvidence(evidence: Evidence): void;
 /**
@@ -39,9 +40,4 @@ export declare function loadEvidenceByType(type: EvidenceType): Evidence[];
 export declare function loadRecentEvidence(limit?: number): Evidence[];
 /** prefer-from-now / avoid-this 교정 evidence를 모두 반환 (규칙 승격 후보) */
 export declare function loadPromotionCandidates(): Evidence[];
-/**
- * 특정 세션의 promotion 후보를 scope:'me' 영구 규칙으로 승격.
- * 동일 render_key를 가진 scope:'me' 규칙이 이미 있으면 건너뜀.
- * @returns 승격된 규칙 수
- */
 export declare function promoteSessionCandidates(sessionId: string): number;

package/dist/store/evidence-store.js

@@ -9,7 +9,8 @@ import * as path from 'node:path';
 import * as crypto from 'node:crypto';
 import { ME_BEHAVIOR } from '../core/paths.js';
 import { atomicWriteJSON, safeReadJSON } from '../hooks/shared/atomic-write.js';
-import { createRule, saveRule, loadActiveRules } from './rule-store.js';
+import { HOST_IDS } from '../core/trust-layer-intent.js';
+import { createRule, saveRule, loadActiveRules, updateRuleStatus } from './rule-store.js';
 import { classify, applyProposal } from '../engine/enforce-classifier.js';
 import { detect as detectT1 } from '../engine/lifecycle/trigger-t1-correction.js';
 import { foldEvents } from '../engine/lifecycle/orchestrator.js';
@@ -32,11 +33,13 @@ function evidencePath(evidenceId) {
 function detectHost(explicit) {
     if (explicit)
         return explicit;
+    // W3-3 리뷰 SEV-3 #5: 이진비교(=== 'claude' || === 'codex') 대신 HOST_IDS 정준목록으로
+    // 유효 host 를 해소해 FORGEN_HOST/FORGEN_RUNTIME='opencode' 도 보존(self-evidence-record 일관).
     const fromEnv = process.env.FORGEN_HOST;
-    if (fromEnv === 'claude' || fromEnv === 'codex')
+    if (fromEnv && HOST_IDS.includes(fromEnv))
         return fromEnv;
     const fromRuntime = process.env.FORGEN_RUNTIME;
-    if (fromRuntime === 'claude' || fromRuntime === 'codex')
+    if (fromRuntime && HOST_IDS.includes(fromRuntime))
         return fromRuntime;
     if (process.env.CODEX_HOME || process.env.CODEX_SANDBOX_NETWORK_DISABLED)
         return 'codex';
@@ -111,13 +114,17 @@ export function appendEvidence(evidence) {
     }
 }
 /**
- * 기존 evidence 에 host 필드가 없으면 'claude' 로 backfill (Multi-Host §4.2 마이그레이션 정책).
- * 새 multi-host 도입 이전 데이터는 모두 Claude 에서 발생했음 — 이 backfill 은 무손실.
+ * 기존 evidence 에 host 필드가 없거나 유효하지 않으면 'claude' 로 backfill
+ * (Multi-Host §4.2 마이그레이션 정책). 새 multi-host 도입 이전 데이터는 모두 Claude 발생.
+ *
+ * W3-3 리뷰 SEV-3 #5: 이전엔 `!== 'claude' && !== 'codex'` 라 **유효한 'opencode' 태그도
+ * claude 로 clobber** → self-evidence-record='supported'(host:"opencode") 선언과 정면 모순.
+ * 이제 HOST_IDS 정준 목록으로 "유효 host" 를 판정해 opencode 등 모든 유효 태그를 보존한다.
  */
 function backfillHost(ev) {
     if (!ev)
         return ev;
-    if (ev.host === 'claude' || ev.host === 'codex')
+    if (ev.host && HOST_IDS.includes(ev.host))
         return ev;
     return { ...ev, host: 'claude' };
 }
@@ -163,7 +170,41 @@ export function loadPromotionCandidates() {
  * 동일 render_key를 가진 scope:'me' 규칙이 이미 있으면 건너뜀.
  * @returns 승격된 규칙 수
  */
+/**
+ * ADR-013 채굴 교정 안전 파라미터 (리뷰 SEV-1 대응):
+ * - 채굴 룰은 "auto:" render_key 네임스페이스로 분리 → 실시간 명시 교정과 절대 충돌/억제 안 함.
+ * - advisory-only: enforce_via=[] (차단 메커니즘 미부여). 환각 교정이 차단 룰이 되는 것 근절.
+ * - 생성나이 은퇴: TTL 지난 미확인 채굴 룰 retire (me-scope 룰이 매 세션 주입돼 ROI/T4 로는
+ *   은퇴 안 되던 문제의 실제 해소). + 라이브 채굴 룰 총량 상한.
+ */
+const AUTO_MINED_PREFIX = 'auto:';
+const AUTO_MINED_TTL_MS = 21 * 24 * 60 * 60 * 1000; // 21일
+const AUTO_MINED_MAX_LIVE = 30;
+/** 채굴(behavior_inference) 룰 은퇴: TTL 초과 + 총량 상한 초과분(오래된 순). */
+function retireStaleAutoMinedRules(now) {
+    const auto = loadActiveRules().filter((r) => r.scope === 'me' && r.source === 'behavior_inference' && r.render_key?.startsWith(AUTO_MINED_PREFIX));
+    const byAge = auto
+        .map((r) => ({ r, age: now - Date.parse(r.created_at) }))
+        .sort((a, b) => b.age - a.age); // 오래된 순
+    const keep = [];
+    for (const item of byAge) {
+        if (item.age >= AUTO_MINED_TTL_MS) {
+            updateRuleStatus(item.r.rule_id, 'removed'); // TTL 초과 → 은퇴
+        }
+        else {
+            keep.push(item);
+        }
+    }
+    // 총량 상한 초과분(가장 오래된 것부터) 은퇴.
+    const excess = keep.length - AUTO_MINED_MAX_LIVE;
+    for (let i = 0; i < excess; i++)
+        updateRuleStatus(keep[i].r.rule_id, 'removed');
+}
 export function promoteSessionCandidates(sessionId) {
+    // 채굴 룰 TTL 은퇴는 **early-return 앞에서** 실행 (critic 재검증 #1): 승급 후보가 없는
+    // 조용한 세션에서도 wall-clock TTL 이 실제로 강제되도록. (auto-compound-runner 는 매
+    // 세션 종료 시 promoteSessionCandidates 를 호출하므로 이 경로가 세션당 1회 보장된다.)
+    retireStaleAutoMinedRules(Date.now());
     const candidates = loadPromotionCandidates().filter(e => e.session_id === sessionId);
     if (candidates.length === 0)
         return 0;
@@ -175,30 +216,43 @@ export function promoteSessionCandidates(sessionId) {
         const axisHint = payload?.axis_hint;
         const target = payload?.target;
         const kind = payload?.kind;
+        const autoMined = payload?.auto_mined === true;
         if (!target)
             continue;
-        const renderKey = `${axisHint ?? 'workflow'}.${target.toLowerCase().replace(/\s+/g, '-').slice(0, 30)}`;
+        // 채굴 룰은 "auto:" 네임스페이스 — 실시간 교정 render_key 와 절대 충돌 안 함 (SEV-2 #4).
+        const baseKey = `${axisHint ?? 'workflow'}.${target.toLowerCase().replace(/\s+/g, '-').slice(0, 30)}`;
+        const renderKey = autoMined ? `${AUTO_MINED_PREFIX}${baseKey}` : baseKey;
         if (existingRenderKeys.has(renderKey))
             continue;
         const category = axisHint === 'quality_safety' ? 'quality'
             : axisHint === 'autonomy' ? 'autonomy'
                 : 'workflow';
+        // ADR-013: 채굴 교정(auto_mined)은 실시간 명시 교정과 엄격 차등 — provenance
+        // =behavior_inference, strength 절대 strong 아님(default).
         let rule = createRule({
             category,
             scope: 'me',
             trigger: target,
             policy: candidate.summary,
-            strength: kind === 'avoid-this' ? 'strong' : 'default',
-            source: 'explicit_correction',
+            strength: autoMined ? 'default' : kind === 'avoid-this' ? 'strong' : 'default',
+            source: autoMined ? 'behavior_inference' : 'explicit_correction',
             evidence_refs: [candidate.evidence_id],
             render_key: renderKey,
         });
-        // ADR-001 auto-classify — 승격되는 rule 에도 enforce_via 자동 주입.
-        try {
-            const proposal = classify(rule);
-            rule = applyProposal(rule, proposal);
+        if (autoMined) {
+            // advisory-only (SEV-1 #2): classify() 를 돌리지 않고 enforce_via 를 비워, 채굴 룰이
+            // 절대 Mech-A 차단(PreToolUse/Stop block)을 얻지 못하게 한다. 컨텍스트 주입만 되고
+            // 어떤 훅도 강제하지 않음 — 환각 교정이 영구 차단 룰이 되는 위험 근절.
+            rule.enforce_via = [];
+        }
+        else {
+            // ADR-001 auto-classify — 실시간 승격 rule 에만 enforce_via 자동 주입.
+            try {
+                const proposal = classify(rule);
+                rule = applyProposal(rule, proposal);
+            }
+            catch { /* fail-open */ }
         }
-        catch { /* fail-open */ }
         saveRule(rule);
         existingRenderKeys.add(renderKey);
         promoted++;

package/dist/store/host-mismatch.d.ts

@@ -11,7 +11,7 @@
  *   - drift_event_count_by_host
  * 위 3 종 metric 을 evidence_id → host 매핑으로 집계.
  */
-export type HostId = 'claude' | 'codex';
+import type { HostId } from '../core/trust-layer-intent.js';
 export interface HostMismatchSummary {
     readonly byHost: Record<HostId, number>;
     readonly total: number;
@@ -33,6 +33,7 @@ export declare function summarizeNegativeSignalsForRef(refId: string): HostMisma
 export declare function summarizeAllByHost(): {
     claude: number;
     codex: number;
+    opencode: number;
     total: number;
 };
 /** 테스트 노출용 — 임계값이 변경되면 회귀 즉시 감지. */

package/dist/store/host-mismatch.js

@@ -15,19 +15,19 @@ import { loadAllEvidence } from './evidence-store.js';
 const DOMINANCE_THRESHOLD = 0.8; // 80% 이상이 한 host 에서 발생하면 dominant.
 const MIN_TOTAL_FOR_DEMOTE = 5; // 너무 적은 표본은 무시.
 function summarize(events) {
-    const byHost = { claude: 0, codex: 0 };
+    const byHost = { claude: 0, codex: 0, opencode: 0 };
     for (const e of events) {
         const h = (e.host ?? 'claude');
         byHost[h] += 1;
     }
-    const total = byHost.claude + byHost.codex;
+    // host-agnostic 집계 — 새 host 추가 시 이 로직은 수정 불필요.
+    const entries = Object.entries(byHost);
+    const total = entries.reduce((s, [, n]) => s + n, 0);
     if (total === 0) {
         return { byHost, total, skew: 0, dominantHost: null, demoteRecommended: false };
     }
-    const claudeShare = byHost.claude / total;
-    const codexShare = byHost.codex / total;
-    const dominant = claudeShare >= codexShare ? 'claude' : 'codex';
-    const skew = Math.max(claudeShare, codexShare);
+    const [dominant, dominantCount] = entries.reduce((max, cur) => (cur[1] > max[1] ? cur : max));
+    const skew = dominantCount / total;
     const demoteRecommended = total >= MIN_TOTAL_FOR_DEMOTE && skew >= DOMINANCE_THRESHOLD;
     return { byHost, total, skew, dominantHost: dominant, demoteRecommended };
 }
@@ -53,10 +53,10 @@ export function summarizeNegativeSignalsForRef(refId) {
 }
 export function summarizeAllByHost() {
     const all = loadAllEvidence();
-    const r = { claude: 0, codex: 0 };
+    const r = { claude: 0, codex: 0, opencode: 0 };
     for (const e of all)
         r[(e.host ?? 'claude')] += 1;
-    return { ...r, total: r.claude + r.codex };
+    return { ...r, total: r.claude + r.codex + r.opencode };
 }
 /** 테스트 노출용 — 임계값이 변경되면 회귀 즉시 감지. */
 export const HOST_MISMATCH_TUNING = {

package/dist/store/profile-store.d.ts

@@ -5,6 +5,7 @@
  * Authoritative schema: docs/plans/2026-04-03-forgen-data-model-storage-spec.md §2
  */
 import type { Profile, QualityPack, AutonomyPack, JudgmentPack, CommunicationPack, TrustPolicy } from './types.js';
+import type { HostId } from '../core/trust-layer-intent.js';
 export declare function createProfile(userId: string, qualityPack: QualityPack, autonomyPack: AutonomyPack, trustPolicy: TrustPolicy, trustSource: Profile['trust_preferences']['source'], judgmentPack?: JudgmentPack, communicationPack?: CommunicationPack): Profile;
 export declare function loadProfile(): Profile | null;
 export declare function loadProfileRaw(): unknown;
@@ -50,7 +51,7 @@ export declare function bumpAxisConfidence(axis: 'quality_safety' | 'autonomy' |
  * fgx / forgen 무인자 실행 시 어느 host 를 spawn 할지 결정. 'ask' 면 매번 묻기.
  * 미설정(undefined) 은 legacy 사용자 호환 — 'claude' 로 resolve.
  */
-export type DefaultHost = 'claude' | 'codex' | 'ask';
+export type DefaultHost = HostId | 'ask';
 export declare function getDefaultHost(): DefaultHost | undefined;
 export declare function setDefaultHost(host: DefaultHost): boolean;
 /**
@@ -58,4 +59,4 @@ export declare function setDefaultHost(host: DefaultHost): boolean;
  * 우선순위: explicit override > profile.default_host > 'claude' fallback.
  * 'ask' 는 caller 가 별도 처리 (interactive prompt).
  */
-export declare function resolveDefaultHost(override?: 'claude' | 'codex'): 'claude' | 'codex' | 'ask';
+export declare function resolveDefaultHost(override?: HostId): DefaultHost;

package/dist/store/types.d.ts

@@ -4,6 +4,7 @@
  * Authoritative source: docs/plans/2026-04-03-forgen-data-model-storage-spec.md
  * Runtime contracts: docs/plans/2026-04-03-forgen-component-interface-design.md
  */
+import type { HostId } from '../core/trust-layer-intent.js';
 export type QualityPack = '보수형' | '균형형' | '속도형';
 export type AutonomyPack = '확인 우선형' | '균형형' | '자율 실행형';
 export type JudgmentPack = '최소변경형' | '균형형' | '구조적접근형';
@@ -110,6 +111,12 @@ export interface Rule {
      * ADR-002 §Data Model.
      */
     lifecycle?: LifecycleState;
+    /**
+     * W3-2 (교정 클러스터링): 이 rule 이 클러스터 통합으로 superseded 되었다면, 통합 결과
+     * rule 의 rule_id. `forgen rules --unmerge-cluster` 로 복원 시 이 링크로 원본을 되살린다.
+     * 통합 rule 쪽에는 설정되지 않는다(원본에만). ADR-010 W3-2.
+     */
+    clustered_into?: string;
 }
 export type EvidenceType = 'explicit_correction' | 'behavior_observation' | 'session_summary';
 export interface Evidence {
@@ -128,7 +135,7 @@ export interface Evidence {
      * evidence 가 어느 host 에서 발생했는지 태그. 미지정 시 'claude' 로 backfill (기존 데이터 호환).
      * core 의 학습 로직은 이 필드를 *호스트별 가중치* 가 아니라 *불일치 demote 신호* 로만 사용한다.
      */
-    host?: 'claude' | 'codex';
+    host?: HostId;
 }
 export interface QualityFacets {
     verification_depth: number;
@@ -187,7 +194,7 @@ export interface Profile {
      *   - 'ask': 매번 묻기 (interactive prompt)
      *   - undefined: legacy / 미설정 → 'claude' fallback (마이그레이션 호환)
      */
-    default_host?: 'claude' | 'codex' | 'ask';
+    default_host?: HostId | 'ask';
 }
 export type RecommendationSource = 'onboarding' | 'mismatch_recommendation';
 export type RecommendationStatus = 'proposed' | 'accepted' | 'archived';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooojin/forgen",
-  "version": "0.4.13",
+  "version": "0.5.0",
   "preferGlobal": true,
   "main": "dist/lib.js",
   "types": "./dist/lib.d.ts",
@@ -79,7 +79,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.16",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^25.9.1",
+    "@types/node": "^26.1.1",
     "@vitest/coverage-v8": "^4.1.7",
     "typescript": "^5.9.3",
     "vitest": "^4.1.7"
@@ -87,6 +87,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.28.0",
     "js-yaml": "^4.1.1",
+    "jsonc-parser": "^3.3.1",
     "zod": "^4.4.3"
   },
   "peerDependencies": {

package/plugin.json

@@ -1,11 +1,11 @@
 {
   "$schema": "https://claude.ai/schemas/claude-plugin.json",
   "name": "forgen",
-  "version": "0.4.13",
+  "version": "0.5.0",
   "description": "Claude Code harness — the more you use Claude, the better it gets",
   "author": {
     "name": "jang-ujin",
-    "url": "https://github.com/wooo-jin"
+    "url": "https://github.com/forgen-team"
   },
   "repository": "https://github.com/forgen-team/forgen",
   "homepage": "https://github.com/forgen-team/forgen",

package/skills/forge-loop/SKILL.md

@@ -65,13 +65,19 @@ PRD 확정 직후 **반드시** `~/.forgen/state/forge-loop.json`에 저장:
 mkdir -p ~/.forgen/state
 cat > ~/.forgen/state/forge-loop.json <<EOF
 {"active":true,"startedAt":"$(date -u +%Y-%m-%dT%H:%M:%SZ)","stories":[
-  {"id":"US-001","title":"...","passes":false,"attempts":0}
+  {"id":"US-001","title":"...","passes":false,"attempts":0,"acceptanceCriteria":["..."]}
 ]}
 EOF
 ```
 
 이 파일이 있어야 Claude가 중간에 멈추지 않도록 Stop 훅이 차단합니다.
+소유 세션은 최초 차단 시점에 Stop 훅이 자동 귀속하므로(`sessionId` 필드) 이
+파일을 쓸 때 세션 ID를 직접 넣을 필요는 없습니다 — 단, 귀속된 세션과 다른
+세션에서는 이 루프가 차단하지 않습니다. 24시간 이상 갱신이 없으면 자동
+해제(1회성 안내 포함)되며, 연속 30회 차단 시에도 안전 상한으로 자동 해제됩니다.
 스토리 완료 시 `passes: true`로 업데이트. 전체 완료는 Stop 훅이 자동 처리.
+`acceptanceCriteria[0]`은 차단 메시지에 `AC1:`로 노출되므로 있으면 첫 항목을
+구체적이고 검증 가능한 문장으로 작성하세요 (없어도 정상 동작).
 
 ### goal-only 모드 — Phase 1 종료 분기
 

package/skills/ship/SKILL.md

@@ -148,10 +148,27 @@ npm version {patch|minor|major} --no-git-tag-version
 
 커밋을 주제별 그룹핑 -> CHANGELOG.md 상단에 추가.
 
+## Step 6.5: Smoke 증거 생성 (forgen 레포 한정)
+
+forgen 레포 자체를 ship 할 때는 릴리스 커밋 전에 smoke 증거를 생성한다
+(ADR-010 W0-2 — CI self-gate 가 릴리스 커밋에서 smoke-report 를 요구).
+
+```bash
+# forgen 레포에서만. vitest 는 Step 3 에서 이미 돌았지만 게이트 증거는
+# smoke.cjs 산출물만 인정 — 전체 실행 (실제 프로세스 산출물 원칙).
+if [ -f scripts/smoke.cjs ]; then
+  node scripts/smoke.cjs || ABORT
+fi
+```
+
+- 실패 -> ABORT ("smoke 증거 생성 실패 — 게이트 통과 불가")
+
 ## Step 7: 릴리스 커밋
 
 ```bash
-git add package.json CHANGELOG.md
+git add package.json package-lock.json CHANGELOG.md
+# forgen 레포: smoke 증거 포함
+[ -f .forgen-release/smoke-report.json ] && git add .forgen-release/smoke-report.json
 git commit -m "release: v{version}"
 ```