@wooojin/forgen 0.5.0 → 0.5.6

package/dist/store/rule-store.js

@@ -160,6 +160,37 @@ function resolveProjectRulesDir() {
 export function loadActiveRules() {
     return loadAllRules().filter(r => r.status === 'active');
 }
+/**
+ * render_key(+source, +scope)로 기존 rule을 찾는다 — status 무관(active/suppressed/removed/
+ * superseded 전부 포함). ADR-013 채굴 룰 재생성 결함 수정(RCA): promoteSessionCandidates가
+ * loadActiveRules() 로만 dedup 하다 보니 TTL/cap 로 은퇴(removed)된 render_key가 재차 채굴되면
+ * "없음" 으로 오판해 매번 새 rule_id + created_at=now 로 재생성 — 이게 6,701개 파일 중
+ * 6,525개가 removed 로 죽어 쌓인 근본 원인. 이 함수로 upsert identity 를 render_key 로
+ * 고정한다: 있으면 재활성화, 없을 때만 신규 생성.
+ *
+ * scope 필터가 필요한 이유: processCorrection()(evidence-processor.ts)이 fix-now/avoid-this
+ * 에 대해 scope:'session' 임시 rule 을 만들 때 *같은 render_key 공식*(`${axis}.${target-slug}`)
+ * 을 쓴다. scope 를 안 걸면 promoteSessionCandidates 가 그 임시 rule 을 "기존 me rule" 로
+ * 오인해 재활성화해버려 영구 승격이 아예 안 되는 회귀가 생긴다(실측: 회귀 테스트로 발견).
+ *
+ * 동일 render_key 매칭이 여럿(레거시 데이터 등 이례적 상황)이면 active 우선, 그다음
+ * updated_at 최신순으로 하나만 반환.
+ */
+export function findRuleByRenderKey(renderKey, source, scope) {
+    const matches = loadAllRules().filter((r) => r.render_key === renderKey
+        && (source === undefined || r.source === source)
+        && (scope === undefined || r.scope === scope));
+    if (matches.length === 0)
+        return null;
+    matches.sort((a, b) => {
+        if (a.status === 'active' && b.status !== 'active')
+            return -1;
+        if (b.status === 'active' && a.status !== 'active')
+            return 1;
+        return b.updated_at.localeCompare(a.updated_at);
+    });
+    return matches[0];
+}
 /**
  * ADR-002 Meta signal — rule 들이 프롬프트에 inject 되었음을 기록.
  * rule.lifecycle.inject_count +1, last_inject_at = now.
@@ -188,10 +219,54 @@ export function updateRuleStatus(ruleId, status) {
     saveRule(rule);
     return true;
 }
+/** removed 룰 보관 기간 기본값 — 7일. TTL 로 은퇴된 지 이만큼 지나면 prune 대상. */
+export const DEFAULT_PRUNE_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
 /**
- * 현재 세션 ID와 다른 scope:'session' 규칙을 비활성화.
- * 이전 세션의 임시 규칙이 새 세션에서 영향을 미치지 않도록 정리.
+ * status:'removed' 파일을 retention 기간이 지난 것만 실제 unlink.
+ * RCA: retire(updateRuleStatus)는 status flip만 하고 파일을 지우지 않아 6,525개 죽은
+ * 파일이 ~/.forgen/me/rules 에 쌓여 loadAllRules() linear scan 비용을 키우고
+ * cross-process race 창을 넓혔다. status 전이 시각(updated_at) 기준으로 retention을
+ * 재는 이유: removed 직후 즉시 지우면 (a) findRuleByRenderKey 가 재활성화할 기회를
+ * 없애고 (b) 오탐 은퇴를 되돌릴 유예가 사라진다.
+ *
+ * 기본 dry-run(apply=false) — 프로덕션 데이터 삭제는 호출측이 명시적으로 apply:true
+ * 를 넘길 때만. (compound-sweep-cli 의 `--prune-removed`는 `--apply` 없으면 dry-run.)
  */
+export function pruneRemovedRules(opts = {}) {
+    const retentionMs = opts.retentionMs ?? DEFAULT_PRUNE_RETENTION_MS;
+    const apply = opts.apply ?? false;
+    const now = Date.now();
+    const candidates = [];
+    const deleted = [];
+    if (!fs.existsSync(ME_RULES))
+        return { candidates, deleted };
+    for (const file of fs.readdirSync(ME_RULES)) {
+        if (!file.endsWith('.json'))
+            continue;
+        const filePath = path.join(ME_RULES, file);
+        const rule = safeReadJSON(filePath, null);
+        if (rule?.status !== 'removed')
+            continue;
+        // 안전 불변식: prune 은 auto-mined advisory churn(결함1의 폭주 산출물)만 삭제한다.
+        // 영구·명시 룰(L1 하드룰, source:'explicit_correction')은 status:'removed' 여도
+        // 파일을 지우지 않는다 — 회귀 시 이력/복구 근거가 되고, 애초에 이 함수의 대상이 아니다.
+        const isAutoMinedChurn = rule.source === 'behavior_inference' || rule.render_key?.startsWith('auto:');
+        if (!isAutoMinedChurn)
+            continue;
+        const age = now - Date.parse(rule.updated_at);
+        if (!Number.isFinite(age) || age < retentionMs)
+            continue;
+        candidates.push(rule.rule_id);
+        if (apply) {
+            try {
+                fs.unlinkSync(filePath);
+                deleted.push(rule.rule_id);
+            }
+            catch { /* best-effort — 다음 prune 에서 재시도 */ }
+        }
+    }
+    return { candidates, deleted };
+}
 export function cleanupStaleSessionRules(_currentSessionId) {
     if (!fs.existsSync(ME_RULES))
         return 0;

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "Forgen harness hooks (auto-generated, 22/22 active)",
+  "description": "Forgen harness hooks (auto-generated, 23/23 active)",
   "hooks": {
     "UserPromptSubmit": [
       {
@@ -195,6 +195,18 @@
           }
         ]
       }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/session-end.js\"",
+            "timeout": 3
+          }
+        ]
+      }
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooojin/forgen",
-  "version": "0.5.0",
+  "version": "0.5.6",
   "preferGlobal": true,
   "main": "dist/lib.js",
   "types": "./dist/lib.d.ts",

package/plugin.json

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

package/skills/architecture-decision/SKILL.md

@@ -1,6 +1,24 @@
 ---
 name: architecture-decision
 description: This skill should be used when the user asks to "adr,ch-architecture decision,아키텍처 결정,설계 결정,기술 결정". ADR 생성 -- 대안 평가, 가중 트레이드오프 매트릭스, 결정 라이프사이클 관리
+argument-hint: "[결정 주제]"
+model: opus
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
+  - Edit
+  - mcp__forgen-compound__compound-search
+  - mcp__forgen-compound__compound-read
+  - mcp__forgen-compound__compound-list
+triggers:
+  - "adr"
+  - "ch-architecture decision"
+  - "아키텍처 결정"
+  - "설계 결정"
+  - "기술 결정"
 ---
 
 <Purpose>

package/skills/calibrate/SKILL.md

@@ -1,6 +1,24 @@
 ---
 name: calibrate
 description: This skill should be used when the user asks to "calibrate, 캘리브레이트, 프로필 보정, 프로필 조정, 프로필 확인". 축적된 evidence(교정 기록)를 분석하여 4축 프로필 조정을 제안합니다.
+argument-hint: "[기간: 7d/30d/90d]"
+model: opus
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - mcp__forgen-compound__compound-search
+  - mcp__forgen-compound__compound-read
+  - mcp__forgen-compound__profile-read
+  - mcp__forgen-compound__correction-record
+triggers:
+  - "calibrate"
+  - "캘리브레이트"
+  - "프로필 보정"
+  - "프로필 조정"
+  - "프로필 확인"
+  - "프로필 업데이트"
 ---
 
 <Purpose>

package/skills/code-review/SKILL.md

@@ -1,6 +1,23 @@
 ---
 name: code-review
 description: This skill should be used when the user asks to "code review,코드 리뷰,리뷰해줘,review this". 신뢰도 보정 기반 체계적 코드 리뷰 — compound 이력 연동, auto-fix, 20개 체크리스트.
+argument-hint: "[file, PR number, or git range]"
+model: opus
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Edit
+  - Write
+  - Agent
+triggers:
+  - "code review"
+  - "코드 리뷰"
+  - "리뷰해줘"
+  - "review this"
+  - "리뷰"
+  - "review"
 ---
 
 <Purpose>

package/skills/compound/SKILL.md

@@ -1,6 +1,23 @@
 ---
 name: compound
 description: This skill should be used when the user asks to "복리화,compound,패턴 추출,솔루션 축적,what did we learn". Compound Engineering — extract reusable patterns from this session's work
+argument-hint: "[solution description]"
+model: inherit
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - mcp__forgen-compound__compound-search
+  - mcp__forgen-compound__compound-read
+  - mcp__forgen-compound__compound-list
+  - mcp__forgen-compound__compound-stats
+triggers:
+  - "복리화"
+  - "compound"
+  - "패턴 추출"
+  - "솔루션 축적"
+  - "what did we learn"
+  - "배운 것 정리"
 ---
 
 <Purpose>

package/skills/deep-interview/SKILL.md

@@ -1,6 +1,13 @@
 ---
 name: deep-interview
 description: This skill should be used when the user asks to "deep-interview,딥인터뷰,심층인터뷰,deep interview". Deep requirement interview with weighted dimension scoring, challenge modes, and ontology tracking
+argument-hint: "[project or feature description]"
+triggers:
+  - "deep-interview"
+  - "딥인터뷰"
+  - "심층인터뷰"
+  - "deep interview"
+  - "요구사항 인터뷰"
 ---
 
 <Purpose>

package/skills/docker/SKILL.md

@@ -1,6 +1,24 @@
 ---
 name: docker
 description: This skill should be used when the user asks to "docker,container,컨테이너,dockerfile,도커,docker-compose". Docker 컨테이너화 -- Dockerfile 최적화, Compose 구성, 보안 강화
+argument-hint: "[컨테이너화 대상]"
+model: sonnet
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
+  - Edit
+  - mcp__forgen-compound__compound-search
+  - mcp__forgen-compound__compound-read
+triggers:
+  - "docker"
+  - "container"
+  - "컨테이너"
+  - "dockerfile"
+  - "도커"
+  - "docker-compose"
 ---
 
 <Purpose>

package/skills/forge-loop/SKILL.md

@@ -1,6 +1,29 @@
 ---
 name: forge-loop
 description: This skill should be used when the user asks to "forge-loop, 포지루프, 끝까지, don't stop, goal, 목표, goal lock, scope lock". 작업을 PRD(User Story)로 분해 + 모든 수용 기준 충족까지 반복 실행. `--goal-only` 플래그로 PRD/수용기준 박제만 (실행 사이클 없이) 가능 — goal-locking pattern lightweight 진입점.
+argument-hint: "[task description] [--goal-only]"
+model: inherit
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Agent
+  - Edit
+  - Write
+triggers:
+  - "forge-loop"
+  - "포지루프"
+  - "끝까지"
+  - "don't stop"
+  - "완료될 때까지"
+  - "루프로 실행"
+  - "goal"
+  - "목표"
+  - "goal lock"
+  - "scope lock"
+  - "completion criteria"
+  - "수용 기준"
 ---
 
 <Purpose>

package/skills/learn/SKILL.md

@@ -1,6 +1,21 @@
 ---
 name: learn
 description: This skill should be used when the user asks to "learn, 학습 관리, compound 정리, 솔루션 정리". Compound 지식의 관리 인터페이스 — 검색, 통계, 가지치기, 내보내기/가져오기.
+argument-hint: "[search {query}|stats|prune|export|import {path}]"
+model: inherit
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+triggers:
+  - "learn"
+  - "학습 관리"
+  - "compound 정리"
+  - "솔루션 정리"
+  - "compound 관리"
+  - "솔루션 관리"
+  - "지식 관리"
 ---
 
 <Purpose>

package/skills/retro/SKILL.md

@@ -1,6 +1,22 @@
 ---
 name: retro
 description: This skill should be used when the user asks to "retro, 회고, retrospective, 돌아보기". Git 메트릭 + compound 건강도 + 학습 추세를 교차 분석하는 회고 리포트.
+argument-hint: "[7d|14d|30d] [compare]"
+model: inherit
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+triggers:
+  - "retro"
+  - "회고"
+  - "retrospective"
+  - "돌아보기"
+  - "주간 회고"
+  - "월간 회고"
+  - "주간회고"
+  - "월간회고"
 ---
 
 <Purpose>

package/skills/ship/SKILL.md

@@ -1,6 +1,24 @@
 ---
 name: ship
 description: This skill should be used when the user asks to "ship, 배포, 릴리스, release". 비대화형 자동 릴리스 파이프라인 — 테스트, 리뷰, 버전, CHANGELOG, PR을 원커맨드로.
+argument-hint: "[patch|minor|major]"
+model: inherit
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Agent
+  - Edit
+  - Write
+triggers:
+  - "ship"
+  - "배포"
+  - "릴리스"
+  - "release"
+  - "릴리즈"
+  - "배포해줘"
 ---
 
 <Purpose>