@wooojin/forgen 0.3.2 → 0.4.1

package/dist/store/types.d.ts

@@ -14,7 +14,79 @@ export type RuleScope = 'me' | 'session';
 export type RuleStrength = 'soft' | 'default' | 'strong' | 'hard';
 export type RuleSource = 'onboarding' | 'explicit_correction' | 'behavior_inference' | 'pack_overlay';
 export type RuleStatus = 'active' | 'suppressed' | 'removed' | 'superseded';
+export type EnforcementMech = 'A' | 'B' | 'C';
+export type HookPoint = 'PreToolUse' | 'PostToolUse' | 'Stop' | 'UserPromptSubmit';
+export type VerifierKind = 'file_exists' | 'pattern_match' | 'tool_arg_regex' | 'artifact_check' | 'self_check_prompt';
+export interface VerifierSpec {
+    kind: VerifierKind;
+    /** 각 kind 별로 의미가 다름 — 예: self_check_prompt 는 `question`, artifact_check 는 `path`+`max_age_s`. */
+    params: Record<string, string | number | boolean>;
+}
+export interface EnforceSpec {
+    mech: EnforcementMech;
+    hook: HookPoint;
+    /** Mech-A/B 에서 필수, Mech-C 에서는 미사용. */
+    verifier?: VerifierSpec;
+    /** Mech-A BLOCK / Mech-B self-check 시 Claude 에게 전달할 reason. */
+    block_message?: string;
+    /** Mech-C drift-score.ts 키 — 정량 판정 불가 규칙의 장기 누적 편향 축. */
+    drift_key?: string;
+    /**
+     * Stop hook 전용: 어시스턴트 응답 텍스트에서 이 규칙을 발화시킬 정규식.
+     * 미지정 시 shared default (완료 선언 키워드 regex) 사용.
+     */
+    trigger_keywords_regex?: string;
+    /**
+     * Stop hook 전용: trigger 가 매칭되더라도 이 regex 가 매칭되면 발화 안 함.
+     * retraction/meta/테스트-맥락 등 false-positive 컨텍스트 차단용.
+     */
+    trigger_exclude_regex?: string;
+    /**
+     * UI 표시용 한 줄 태그 (Stop hook 의 `systemMessage` 로 전달).
+     * 예: "rule:R-B1 — e2e-before-done"
+     */
+    system_tag?: string;
+}
+export type LifecyclePhase = 'active' | 'flagged' | 'suppressed' | 'retired' | 'merged' | 'superseded';
+export interface MetaPromotion {
+    at: string;
+    from_mech: EnforcementMech;
+    to_mech: EnforcementMech;
+    reason: 'consistent_adherence' | 'repeated_violation' | 'user_override' | 'stuck_loop_force_approve';
+    trigger_stats: {
+        window_n: number;
+        adherence_rate?: number;
+        violation_count?: number;
+    };
+}
+export interface LifecycleState {
+    phase: LifecyclePhase;
+    first_active_at: string;
+    last_inject_at?: string;
+    last_violation_at?: string;
+    inject_count: number;
+    accept_count: number;
+    violation_count: number;
+    /** T3: 사용자가 rule 과 반대로 행동한 횟수 */
+    bypass_count: number;
+    /** T5: 충돌하는 rule_id 목록 */
+    conflict_refs: string[];
+    /** T5: 이 rule 이 흡수된 대상 rule_id */
+    merged_into?: string;
+    /** T1: 이 rule 을 교체한 rule_id */
+    superseded_by?: string;
+    /** Meta: mech 변경 이력 */
+    meta_promotions: MetaPromotion[];
+}
+/**
+ * Rule JSON schema version. v0.4.0 introduces `enforce_via` + `lifecycle` — 이들을
+ * 포함하는 schema 의 공식 버전은 1. 누락된 rule 파일은 pre-v0.4.0 으로 취급 (optional fields
+ * 만 비어있을 뿐 로드 가능). 미래 breaking change 시 이 값을 증가시키고 `migrate()` 체인으로 흡수.
+ */
+export declare const CURRENT_RULE_SCHEMA_VERSION = 1;
 export interface Rule {
+    /** R5-B3: 미래 breaking schema change 를 위한 version 필드. 없으면 v0 (pre-0.4.0) 으로 취급. */
+    schema_version?: number;
     rule_id: string;
     category: RuleCategory;
     scope: RuleScope;
@@ -27,6 +99,17 @@ export interface Rule {
     render_key: string;
     created_at: string;
     updated_at: string;
+    /**
+     * 이 rule 이 어떤 hook/verifier 로 강제되는가. optional — 기존 rule 은 null.
+     * `forgen classify-enforce` 명령이 기존 rule 을 자동 분류하여 채운다.
+     * ADR-001 §Data Model.
+     */
+    enforce_via?: EnforceSpec[];
+    /**
+     * Lifecycle 상태. optional — 기존 rule 은 load 시 phase='active' 로 auto-initialize.
+     * ADR-002 §Data Model.
+     */
+    lifecycle?: LifecycleState;
 }
 export type EvidenceType = 'explicit_correction' | 'behavior_observation' | 'session_summary';
 export interface Evidence {

package/dist/store/types.js

@@ -4,4 +4,10 @@
  * 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
  */
-export {};
+// ── Rule ────────────────────────────────────────────────────────────────────
+/**
+ * Rule JSON schema version. v0.4.0 introduces `enforce_via` + `lifecycle` — 이들을
+ * 포함하는 schema 의 공식 버전은 1. 누락된 rule 파일은 pre-v0.4.0 으로 취급 (optional fields
+ * 만 비어있을 뿐 로드 가능). 미래 breaking change 시 이 값을 증가시키고 `migrate()` 체인으로 흡수.
+ */
+export const CURRENT_RULE_SCHEMA_VERSION = 1;

package/hooks/hook-registry.json

@@ -5,6 +5,7 @@
   { "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 },

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "Forgen harness hooks (auto-generated, 19/19 active)",
+  "description": "Forgen harness hooks (auto-generated, 20/20 active)",
   "hooks": {
     "UserPromptSubmit": [
       {
@@ -102,6 +102,11 @@
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/context-guard.js\"",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/stop-guard.js\"",
+            "timeout": 10
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooojin/forgen",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "preferGlobal": true,
   "main": "dist/lib.js",
   "types": "./dist/lib.d.ts",
@@ -30,11 +30,11 @@
     "postinstall": "node scripts/postinstall.js",
     "prepare": "npm run build",
     "prepublishOnly": "npm test",
-    "prepack": "node scripts/prepack-hooks.cjs"
+    "prepack": "npm run build && node scripts/prepack-hooks.cjs"
   },
   "author": "jang-ujin",
   "license": "MIT",
-  "description": "Code, forged for you — personalized Claude Code harness",
+  "description": "When Claude says 'done', forgen makes it prove it — turn-level self-verification + personalized rules, at $0 extra API cost.",
   "keywords": [
     "claude-code",
     "forgen",
@@ -86,5 +86,13 @@
     "@modelcontextprotocol/sdk": "^1.28.0",
     "js-yaml": "^4.1.1",
     "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-code": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-code": {
+      "optional": true
+    }
   }
 }

package/plugin.json

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