@wooojin/forgen 0.6.6 → 0.6.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://claude.ai/schemas/claude-plugin.json",
3
3
  "name": "forgen",
4
- "version": "0.6.6",
4
+ "version": "0.6.8",
5
5
  "description": "Claude Code harness — the more you use Claude, the better it gets",
6
6
  "author": {
7
7
  "name": "jang-ujin",
package/CHANGELOG.md CHANGED
@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.6.8] — 2026-10-07 — mock 룰 표 행 오탐 수정
11
+
12
+ ### Fixed
13
+ - **mock 룰이 마크다운 표 칸의 룰 이름에 걸리던 것.** 문장 단위 판정에서 표 행 하나가 한 문장이 되어, "| mock 검증 | 26 | 1 |" 처럼
14
+ 룰 이름을 표에 적기만 해도 차단됐다(0.6.7 실사용). 표 행은 제외. 업그레이드 시 사용자 룰을 다시 굽도록 마이그레이션 마커를 v2 로 올림.
15
+
16
+ ## [0.6.7] — 2026-10-07 — Stop 룰 재설계: 룰별 발동 조건 · critic 실행 증거 판정 (ADR-018)
17
+
18
+ 30일 실대화 2,671턴 리플레이로 드러난 Stop 룰 결함을 고쳤다. 차단 총량은 비슷하지만(하나 이상 차단된 턴 71 → 85),
19
+ 같은 완료 어휘에 여러 룰이 함께 걸리던 구조가 각 룰이 자기 위반에만 걸리는 구조로 바뀌었다.
20
+
21
+ ### Fixed
22
+ - **제외 조건이 메시지 전체를 보던 결함.** 다른 문장의 "없습니다" 때문에 정상 완료 보고의 67% 를 놓쳤다. 이제 매칭된 문장에만 적용.
23
+ - **mock 룰이 단어 하나에 걸리던 것.** "mock 으로 검증·통과했다"는 주장에만 반응한다(26 → 3). forgen 저장소의 프로젝트 룰도 함께 갱신.
24
+ - **critic 룰이 "위반 없음" 자기 신고로 통과하던 것.** 최근 도구 호출 60개 안에 Agent·Task·Workflow 실행 기록이 있어야 통과한다.
25
+
26
+ ### Changed
27
+ - **룰별 발동 조건.** 주제 룰(번호 매긴 기능 + 빼기 제안, 45 → 4), 격리 룰(실 데이터에 대고 돌렸다, 45 → 5),
28
+ 구현 먼저 룰("바로 구현했다", 45 → 1), 언어 룰(한글 비율 기계 판정), critic 룰(커밋 증거가 있는 완료·커밋·배포).
29
+ - 업그레이드 시 사용자 룰의 Stop 설정을 한 번 자동으로 다시 굽는다. 수동 확인·적용: `forgen rule classify --stop-only [--apply]`.
30
+
10
31
  ## [0.6.6] — 2026-10-07 — 실사용 관측 반영: 소진 예측 · 로그 부채 · eval 격리 · 룰 병합 2차 · statusline 체인 · recall 입력 정리
11
32
 
12
33
  배포 후 약 19시간 실사용 데이터로 관측하고, 드러난 결함과 남은 과제를 묶었다. Fable critic 통합 리뷰(조건부 승인) SEV-2 3건 반영.
package/README.ja.md CHANGED
@@ -537,6 +537,7 @@ forgen rule activate <id> # suppressed ルールを再アクティブ化
537
537
  forgen rule scan [--apply] # ライフサイクルトリガー実行 (昇格/降格/引退)
538
538
  forgen rule health-scan # drift → Mech 降格候補をスキャン
539
539
  forgen rule classify # 既存ルールに enforce_via を自動提案
540
+ forgen rule classify --stop-only # Stop ルールの発動条件だけを再生成 (既定はプレビュー、--apply で保存)
540
541
  forgen rule merge-mined [--apply] # マイニング(auto:)ルール同士を統合、同概念の explicit ルールにはリンクのみ (既定 dry-run)
541
542
  forgen rule unmerge <id> # 統合/リンクされたルールの原本を復元
542
543
  forgen rule enforce|advise <id> # 自動降格されたルールのブロック復帰 / 記録のみモード (hard ルールは拒否)
package/README.ko.md CHANGED
@@ -522,6 +522,7 @@ forgen rule activate <id> # suppressed 규칙 재활성화
522
522
  forgen rule scan [--apply] # 수명주기 트리거 실행 (승격/강등/은퇴)
523
523
  forgen rule health-scan # drift → Mech 강등 후보 스캔
524
524
  forgen rule classify # 레거시 규칙에 enforce_via 자동 제안
525
+ forgen rule classify --stop-only # Stop 룰 발동 조건만 다시 굽기 (기본 미리보기, --apply 로 저장)
525
526
  forgen rule merge-mined [--apply] # 채굴(auto:) 규칙끼리 병합, 같은 개념의 explicit 규칙엔 링크만 (기본 dry-run)
526
527
  forgen rule unmerge <id> # 병합/링크된 규칙의 원본 복원
527
528
  forgen rule enforce|advise <id> # 자동 강등된 규칙의 차단 복귀 / 기록만 모드 (hard 규칙은 거부)
package/README.md CHANGED
@@ -719,6 +719,7 @@ forgen rule activate <id> # Re-activate a suppressed rule
719
719
  forgen rule scan [--apply] # Run lifecycle triggers (promote/demote/retire)
720
720
  forgen rule health-scan # Scan drift → Mech downgrade candidates
721
721
  forgen rule classify # Propose enforce_via for legacy rules
722
+ forgen rule classify --stop-only # Re-bake only Stop-rule triggers (dry-run; --apply to save)
722
723
  forgen rule merge-mined [--apply] # Merge mined (auto:) rules among themselves; link same-concept ones to explicit rules (dry-run by default)
723
724
  forgen rule unmerge <id> # Restore originals of a merged/linked rule
724
725
  forgen rule enforce|advise <id> # Restore blocking for an auto-demoted rule / record-only mode (hard rules refused)
package/README.zh.md CHANGED
@@ -506,6 +506,7 @@ forgen rule activate <id> # 重新激活 suppressed 规则
506
506
  forgen rule scan [--apply] # 运行生命周期触发器 (晋升/降级/退役)
507
507
  forgen rule health-scan # 扫描 drift → Mech 降级候选
508
508
  forgen rule classify # 为旧规则自动提议 enforce_via
509
+ forgen rule classify --stop-only # 仅重新生成 Stop 规则的触发条件 (默认预览,--apply 保存)
509
510
  forgen rule merge-mined [--apply] # 挖掘(auto:)规则之间合并,与同概念 explicit 规则仅建立链接 (默认 dry-run)
510
511
  forgen rule unmerge <id> # 恢复已合并/链接规则的原件
511
512
  forgen rule enforce|advise <id> # 恢复自动降级规则的拦截 / 仅记录模式 (hard 规则拒绝)
@@ -8,6 +8,10 @@
8
8
  import { loadAllRules, saveRule } from '../store/rule-store.js';
9
9
  import { classifyAll, applyProposal } from './enforce-classifier.js';
10
10
  export async function handleClassifyEnforce(args) {
11
+ if (args.includes('--stop-only')) {
12
+ await handleRetuneStop(args.includes('--apply'));
13
+ return;
14
+ }
11
15
  const apply = args.includes('--apply');
12
16
  const force = args.includes('--force');
13
17
  const rules = loadAllRules();
@@ -59,3 +63,39 @@ export async function handleClassifyEnforce(args) {
59
63
  console.log(` Summary: ${skipped} proposal(s) previewed. Run with --apply to save.\n`);
60
64
  }
61
65
  }
66
+ /**
67
+ * `forgen rule classify --stop-only [--apply]` (2026-10-07) — Stop 훅을 가진 활성 룰의 **Stop 설정만** 현재 분류기로
68
+ * 다시 굽는다(다른 훅 설정·강도·본문 불변). 기본 dry-run 으로 룰별 발동 조건 종류와 판정 방식 변화를 보여준다.
69
+ */
70
+ async function handleRetuneStop(apply) {
71
+ const { loadActiveRules, projectRuleOverridePath } = await import('../store/rule-store.js');
72
+ const fs = await import('node:fs');
73
+ const { chooseStopTrigger, retuneStopSpecs } = await import('./enforce-classifier.js');
74
+ const rules = loadActiveRules().filter((r) => (r.enforce_via ?? []).some((s) => s.hook === 'Stop'));
75
+ console.log(`\n Stop 룰 재조정 — ${rules.length}개 (${apply ? 'APPLY' : 'dry-run'})\n`);
76
+ let changed = 0;
77
+ const changes = new Map(retuneStopSpecs(rules).map((c) => [c.rule.rule_id, c.newStop]));
78
+ for (const rule of rules) {
79
+ const oldStop = (rule.enforce_via ?? []).filter((s) => s.hook === 'Stop');
80
+ const newStop = changes.get(rule.rule_id) ?? oldStop;
81
+ const kept = (rule.enforce_via ?? []).filter((s) => s.hook !== 'Stop');
82
+ const same = !changes.has(rule.rule_id);
83
+ const kind = chooseStopTrigger(rule.policy).kind;
84
+ console.log(` ${same ? '=' : '↻'} ${rule.rule_id.slice(0, 8)} [${kind}] ${oldStop.map((s) => s.verifier?.kind).join(',')} → ${newStop.map((s) => s.verifier?.kind).join(',')} "${rule.policy.slice(0, 50)}"`);
85
+ if (!same)
86
+ changed += 1;
87
+ if (apply && !same)
88
+ saveRule({ ...rule, enforce_via: [...kept, ...newStop] });
89
+ // 프로젝트 룰(<cwd>/.forgen/rules)이 같은 id 를 덮어쓰면 사용자 파일만 고쳐선 효과가 없다 — 그 파일의 Stop 설정도 갱신.
90
+ const proj = projectRuleOverridePath(rule.rule_id);
91
+ if (proj && !same) {
92
+ console.log(` ↳ 프로젝트 룰 파일이 이 룰을 덮어씀: ${proj}${apply ? ' — 함께 갱신(커밋 필요)' : ''}`);
93
+ if (apply) {
94
+ const pr = JSON.parse(fs.readFileSync(proj, 'utf-8'));
95
+ pr.enforce_via = [...(pr.enforce_via ?? []).filter((s) => s.hook !== 'Stop'), ...newStop];
96
+ fs.writeFileSync(proj, `${JSON.stringify(pr, null, 2)}\n`);
97
+ }
98
+ }
99
+ }
100
+ console.log(`\n 변경 ${changed}개${apply ? ' 저장됨' : ' (적용: --apply)'}\n`);
101
+ }
@@ -18,7 +18,7 @@
18
18
  * - 미리 존재하는 enforce_via 는 덮어쓰지 않음 (`force=false` 기본).
19
19
  * - 신규 제안은 reason 주석(문자열) 과 함께 반환해 사용자 리뷰 가능.
20
20
  */
21
- import type { Rule, EnforceSpec } from '../store/types.js';
21
+ import type { Rule, EnforceSpec, VerifierSpec } from '../store/types.js';
22
22
  export interface EnforceProposal {
23
23
  rule_id: string;
24
24
  trigger_preview: string;
@@ -26,6 +26,33 @@ export interface EnforceProposal {
26
26
  proposed: EnforceSpec[];
27
27
  reasoning: string[];
28
28
  }
29
+ /** 룰이 괄호 안에 ①·② 나 · 로 나열한 기능 이름 — 주제 룰 판별용 (예: "(①원·투모션·④슈터 유형·⑤대표 선수)"). */
30
+ export declare function extractTopicTerms(policy: string): string[];
31
+ /**
32
+ * 2026-10-07: 활성 룰 중 Stop 설정이 있는 것만 현재 분류기로 다시 굽는다(다른 훅·강도·본문 불변).
33
+ * 순수 계산 — 저장은 호출자가. 반환: 바뀐 룰과 새 Stop 설정.
34
+ */
35
+ export declare function retuneStopSpecs(rules: Rule[]): Array<{
36
+ rule: Rule;
37
+ newStop: NonNullable<Rule['enforce_via']>;
38
+ }>;
39
+ /** 사용자 룰(~/.forgen/me/rules)에 retune 을 적용·저장. postinstall 1회 마이그레이션용. 반환: 바뀐 수. */
40
+ export declare function applyStopRetuneToUserRules(): Promise<number>;
41
+ /**
42
+ * 발동 조건 종류에 맞는 판정 방식 — 분류기의 모든 Stop 분기가 이 하나를 쓴다(critic SEV-1: 분기마다 따로 고르다
43
+ * language 트리거에 self_check 가 붙어 40자 이상 모든 답변을 차단하는 조합이 생겼다).
44
+ */
45
+ export declare function stopVerifierFor(kind: StopTriggerChoice['kind'], policy: string): VerifierSpec;
46
+ export interface StopTriggerChoice {
47
+ trigger: string;
48
+ exclude: string;
49
+ kind: 'mock' | 'critic' | 'live' | 'impl' | 'topic' | 'completion' | 'language';
50
+ }
51
+ /**
52
+ * 2026-10-07 룰별 발동 조건 — 각 룰이 지키려는 **행동의 주장**에만 반응한다(30일 실측: 공통 완료 어휘는 1.4% 만 발동,
53
+ * 걸리면 4개 룰이 동시에, mock 룰은 단어만으로 무한 반복). 우선순위: mock > critic > 주제 > 격리 > 구현먼저 > 완료.
54
+ */
55
+ export declare function chooseStopTrigger(policy: string): StopTriggerChoice;
29
56
  export declare function classify(rule: Rule): EnforceProposal;
30
57
  export declare function classifyAll(rules: Rule[]): EnforceProposal[];
31
58
  /**
@@ -39,7 +39,87 @@ const PROHIBITION_PATTERN = /(하지\s*마라|하지\s*말|말\s*것|금지)/;
39
39
  */
40
40
  const EVIDENCE_CONTEXT_PATTERN = /(증거|evidence|검증\s*결과|e2e-result|smoke-report)/i;
41
41
  // R6-F2: shared single source of truth — stop-guard 와 동일 regex 재사용.
42
- import { DEFAULT_STOP_TRIGGER_RE as STOP_COMPLETION_TRIGGER, DEFAULT_STOP_EXCLUDE_RE as STOP_COMPLETION_EXCLUDE, MOCK_TRIGGER_RE as STOP_MOCK_TRIGGER, MOCK_EXCLUDE_RE as STOP_MOCK_EXCLUDE, CRITIC_STOP_TRIGGER_RE, CRITIC_STOP_EXCLUDE_RE, } from '../hooks/shared/stop-triggers.js';
42
+ import { DEFAULT_STOP_EXCLUDE_RE as STOP_COMPLETION_EXCLUDE, MOCK_EXCLUDE_RE as STOP_MOCK_EXCLUDE, CRITIC_STOP_EXCLUDE_RE, COMPLETION_TRIGGER_V2_RE, CRITIC_TRIGGER_V2_RE, CHUNK_EVIDENCE_RE, MOCK_CLAIM_TRIGGER_RE, LIVE_RUN_TRIGGER_RE, IMPL_REPORT_TRIGGER_RE, topicDropTrigger, } from '../hooks/shared/stop-triggers.js';
43
+ const ISOLATION_PATTERN = /(격리|isolat|FORGEN_HOME|CLAUDE_CONFIG_DIR|docker).{0,80}(프로덕션|실\s?데이터|live|라이브|실제)|((프로덕션|실\s?데이터|live|라이브).{0,80}(격리|docker|FORGEN_HOME))/is;
44
+ const IMPL_FIRST_PATTERN = /(구현\s?먼저|구현을?\s?먼저|합의.{0,30}(문서|구현)|결정\s?문서|문서로\s?남긴\s?다음|문서화한\s?(후|뒤|다음))/;
45
+ /** 룰이 괄호 안에 ①·② 나 · 로 나열한 기능 이름 — 주제 룰 판별용 (예: "(①원·투모션·④슈터 유형·⑤대표 선수)"). */
46
+ export function extractTopicTerms(policy) {
47
+ // 번호(①~⑨)가 붙은 기능 나열만 주제로 본다 — '·' 만 있는 괄호(예: 오차 규약 통일·거리 스케일)는 절차 설명이라 제외.
48
+ const m = policy.match(/\(([^()]*[①②③④⑤⑥⑦⑧⑨][^()]*)\)/);
49
+ if (!m)
50
+ return [];
51
+ // 번호가 항목 경계 — "①원·투모션·④슈터 유형" 은 [원·투모션, 슈터 유형]. 항목 끝의 구분자만 벗긴다.
52
+ return m[1].split(/[①-⑨]/).map((t) => t.replace(/^[\s·,]+|[\s·,]+$/g, '').trim()).filter((t) => t.length >= 2);
53
+ }
54
+ /** 트리거 정규식 상한(compileSafeRegex MAX_PATTERN_LEN=500)보다 여유 있게 — 넘으면 룰이 소리 없이 죽는다. */
55
+ const TOPIC_TRIGGER_MAX = 480;
56
+ /**
57
+ * 2026-10-07: 활성 룰 중 Stop 설정이 있는 것만 현재 분류기로 다시 굽는다(다른 훅·강도·본문 불변).
58
+ * 순수 계산 — 저장은 호출자가. 반환: 바뀐 룰과 새 Stop 설정.
59
+ */
60
+ export function retuneStopSpecs(rules) {
61
+ const out = [];
62
+ for (const rule of rules) {
63
+ if (rule.status !== 'active' || !(rule.enforce_via ?? []).some((s) => s.hook === 'Stop'))
64
+ continue;
65
+ const newStop = classify(rule).proposed.filter((s) => s.hook === 'Stop');
66
+ if (newStop.length === 0)
67
+ continue;
68
+ const oldStop = (rule.enforce_via ?? []).filter((s) => s.hook === 'Stop');
69
+ if (JSON.stringify(oldStop) !== JSON.stringify(newStop))
70
+ out.push({ rule, newStop });
71
+ }
72
+ return out;
73
+ }
74
+ /** 사용자 룰(~/.forgen/me/rules)에 retune 을 적용·저장. postinstall 1회 마이그레이션용. 반환: 바뀐 수. */
75
+ export async function applyStopRetuneToUserRules() {
76
+ const { loadAllRules, saveRule } = await import('../store/rule-store.js');
77
+ const changes = retuneStopSpecs(loadAllRules());
78
+ for (const { rule, newStop } of changes) {
79
+ saveRule({ ...rule, enforce_via: [...(rule.enforce_via ?? []).filter((s) => s.hook !== 'Stop'), ...newStop] });
80
+ }
81
+ return changes.length;
82
+ }
83
+ /**
84
+ * 발동 조건 종류에 맞는 판정 방식 — 분류기의 모든 Stop 분기가 이 하나를 쓴다(critic SEV-1: 분기마다 따로 고르다
85
+ * language 트리거에 self_check 가 붙어 40자 이상 모든 답변을 차단하는 조합이 생겼다).
86
+ */
87
+ export function stopVerifierFor(kind, policy) {
88
+ if (kind === 'critic') {
89
+ return { kind: 'tool_evidence', params: { tools: 'Agent,Task,Workflow,mcp__forgen-compound__invoke-agent', window: 60, only_if: CHUNK_EVIDENCE_RE, question: `이 작업 청크에 대해 fresh-context 비판 리뷰(critic 에이전트)를 실제로 돌리지 않았다. 규칙: "${policy.slice(0, 100)}". critic 을 실행하고 발견 사항을 반영한 뒤 다시 보고하라.` } };
90
+ }
91
+ if (kind === 'language') {
92
+ return { kind: 'language_ratio', params: { script: 'hangul', min_ratio: 0.5, question: `직전 응답이 한국어가 아니다(한글 비율 미달). 규칙: "${policy.slice(0, 80)}". 한국어로 다시 답하라.` } };
93
+ }
94
+ return { kind: 'self_check_prompt', params: { question: `직전 응답이 다음 규칙을 위반했는지 자가점검하라: "${policy.slice(0, 120)}". 위반 시 구체적 근거와 함께 수정해 재응답하라.` } };
95
+ }
96
+ const KOREAN_ONLY_PATTERN = /(한국어로|한글로).{0,30}(답|응답|작성|말)|영어로\s?답하지/;
97
+ /**
98
+ * 2026-10-07 룰별 발동 조건 — 각 룰이 지키려는 **행동의 주장**에만 반응한다(30일 실측: 공통 완료 어휘는 1.4% 만 발동,
99
+ * 걸리면 4개 룰이 동시에, mock 룰은 단어만으로 무한 반복). 우선순위: mock > critic > 주제 > 격리 > 구현먼저 > 완료.
100
+ */
101
+ export function chooseStopTrigger(policy) {
102
+ if (/mock|stub|fake/i.test(policy))
103
+ return { trigger: MOCK_CLAIM_TRIGGER_RE, exclude: STOP_MOCK_EXCLUDE, kind: 'mock' };
104
+ // 언어 룰: 모든 답변(40자 이상)을 한글 비율로 기계 판정 — 준수하면 조용히 통과하므로 넓게 걸어도 노이즈 없음.
105
+ if (KOREAN_ONLY_PATTERN.test(policy))
106
+ return { trigger: '[\\s\\S]{40,}', exclude: '(?!)', kind: 'language' };
107
+ if (CRITIC_REVIEW_PATTERN.test(policy))
108
+ return { trigger: CRITIC_TRIGGER_V2_RE, exclude: CRITIC_STOP_EXCLUDE_RE, kind: 'critic' };
109
+ const topics = extractTopicTerms(policy);
110
+ if (topics.length > 0) {
111
+ // 상한을 넘으면 앞쪽 기능부터 남긴다(룰이 통째로 죽는 것보다 낫다).
112
+ let n = topics.length;
113
+ while (n > 1 && topicDropTrigger(topics.slice(0, n)).length > TOPIC_TRIGGER_MAX)
114
+ n--;
115
+ return { trigger: topicDropTrigger(topics.slice(0, n)), exclude: STOP_COMPLETION_EXCLUDE, kind: 'topic' };
116
+ }
117
+ if (ISOLATION_PATTERN.test(policy))
118
+ return { trigger: LIVE_RUN_TRIGGER_RE, exclude: STOP_COMPLETION_EXCLUDE, kind: 'live' };
119
+ if (IMPL_FIRST_PATTERN.test(policy))
120
+ return { trigger: IMPL_REPORT_TRIGGER_RE, exclude: STOP_COMPLETION_EXCLUDE, kind: 'impl' };
121
+ return { trigger: COMPLETION_TRIGGER_V2_RE, exclude: STOP_COMPLETION_EXCLUDE, kind: 'completion' };
122
+ }
43
123
  /**
44
124
  * critic-review 룰 감지 (2026-07-22, 리뷰 SEV-2 #3): "비판 리뷰/critic 을 돌리고 다음으로
45
125
  * 넘어감" 정책만 skip-review 트리거를 받는다. e2e·mock 등 다른 완료룰은 DEFAULT(완료 전용)
@@ -105,10 +185,9 @@ export function classify(rule) {
105
185
  }
106
186
  if (isCompletion && !isRepeal) {
107
187
  const mockAsProof = /mock|stub|fake/i.test(text);
108
- const criticReview = CRITIC_REVIEW_PATTERN.test(text);
109
- // 트리거 선택: mock > critic-review > 완료-전용. critic 만 skip-review 시그널 포함.
110
- const stopTrigger = mockAsProof ? STOP_MOCK_TRIGGER : criticReview ? CRITIC_STOP_TRIGGER_RE : STOP_COMPLETION_TRIGGER;
111
- const stopExclude = mockAsProof ? STOP_MOCK_EXCLUDE : criticReview ? CRITIC_STOP_EXCLUDE_RE : STOP_COMPLETION_EXCLUDE;
188
+ const choice = chooseStopTrigger(rule.policy);
189
+ const stopTrigger = choice.trigger;
190
+ const stopExclude = choice.exclude;
112
191
  const pathMatch = text.match(ARTIFACT_PATH_PATTERN)?.[0];
113
192
  // 증거로 보이는 경로만 게이트화: .forgen/ 하위이거나 텍스트에 증거 맥락어가 있을 때.
114
193
  const explicitArtifact = pathMatch && (pathMatch.includes('.forgen/') || EVIDENCE_CONTEXT_PATTERN.test(text))
@@ -134,12 +213,8 @@ export function classify(rule) {
134
213
  proposed.push({
135
214
  mech: 'B',
136
215
  hook: 'Stop',
137
- verifier: {
138
- kind: 'self_check_prompt',
139
- params: {
140
- question: `직전 응답이 다음 규칙을 위반했는지 자가점검하라: "${rule.policy.slice(0, 120)}". 위반 시 구체적 근거와 함께 수정해 재응답하라.`,
141
- },
142
- },
216
+ // critic → 실행 증거, language → 한글 비율, 그 외 자가점검 (stopVerifierFor 단일 소스).
217
+ verifier: stopVerifierFor(choice.kind, rule.policy),
143
218
  trigger_keywords_regex: stopTrigger,
144
219
  trigger_exclude_regex: stopExclude,
145
220
  system_tag: `rule:${rule.rule_id.slice(0, 8)} — completion-self-check`,
@@ -153,14 +228,10 @@ export function classify(rule) {
153
228
  proposed.push({
154
229
  mech: 'B',
155
230
  hook: 'Stop',
156
- verifier: {
157
- kind: 'self_check_prompt',
158
- params: {
159
- question: `직전 응답이 다음 규칙을 위반했는지 자가점검하라: "${rule.policy.slice(0, 120)}". 위반 시 구체적 근거와 함께 수정해 재응답하라.`,
160
- },
161
- },
162
- trigger_keywords_regex: STOP_COMPLETION_TRIGGER,
163
- trigger_exclude_regex: STOP_COMPLETION_EXCLUDE,
231
+ // 2026-10-07: 문체 룰도 룰별 발동 조건(주제·격리·구현먼저·언어 등)과 그에 맞는 판정 방식을 쓴다. 해당 없으면 완료 선언.
232
+ verifier: stopVerifierFor(chooseStopTrigger(rule.policy).kind, rule.policy),
233
+ trigger_keywords_regex: chooseStopTrigger(rule.policy).trigger,
234
+ trigger_exclude_regex: chooseStopTrigger(rule.policy).exclude,
164
235
  system_tag: `rule:${rule.rule_id.slice(0, 8)} — style-check`,
165
236
  });
166
237
  reasoning.push(isStyle ? 'style/tone keyword → Mech-B Stop+self_check_prompt' : 'strong/hard strength + non-mechanical → Mech-B Stop+self_check_prompt');
@@ -25,7 +25,9 @@ import { appendImplicitFeedback } from '../store/implicit-feedback-store.js';
25
25
  import { emitSolutionEvent, querySurfacedWithin } from '../core/observability-store.js';
26
26
  import { parseSolutionV3 } from '../engine/solution-format.js';
27
27
  import { ME_SOLUTIONS } from '../core/paths.js';
28
- const RECENT_TOOL_NAMES_WINDOW = 20;
28
+ // 2026-10-07: 20→60 — critic 룰의 실행 증거 판정(stop-guard tool_evidence)이 'critic 실행 → 수정 수십 회 → 커밋' 흐름에서
29
+ // critic 호출이 창 밖으로 밀려 오탐하지 않도록. 측정 도구 집계는 끝에서 세므로 영향 없음.
30
+ const RECENT_TOOL_NAMES_WINDOW = 60;
29
31
  /** Lightweight hash for content comparison (not cryptographic) */
30
32
  function simpleHash(content) {
31
33
  let hash = 0;
@@ -25,18 +25,21 @@ export declare const DEFAULT_STOP_TRIGGER_RE = "(\uC644\uB8CC\uD588|\uC644\uC131
25
25
  export declare const DEFAULT_STOP_EXCLUDE_RE = "(\uCDE8\uC18C|\uCCA0\uD68C|\uC5C6\uC74C|\uC5C6\uC2B5\uB2C8\uB2E4|\uC54A\uC558|\uD558\uC9C0\\s*\uC54A|\uC544\uB2D9\uB2C8\uB2E4|not\\s*yet|no\\s*longer|retract|withdraw|\uC544\uC9C1\\s*(\uC548|\uC544))";
26
26
  /** mock/stub/fake 감지 — R-B2 전용 pattern (자가검증 주장 차단). */
27
27
  export declare const MOCK_TRIGGER_RE = "(mock|stub|fake)";
28
- /** mock trigger 의 exclude — 테스트 맥락은 정상. */
29
- export declare const MOCK_EXCLUDE_RE = "(\uD14C\uC2A4\uD2B8|test|vi\\.mock|jest\\.mock|spec\\.)";
28
+ /**
29
+ * mock trigger 의 exclude — 테스트 맥락은 정상. 2026-10-07: 문장 단위 판정으로 바뀌며 추가 —
30
+ * mock 을 **벗어나는** 서술(해소·제거·대체·라이브로 재검증·실제 실행·아님)은 위반 주장이 아니다(실측 오탐 예시 근거).
31
+ */
32
+ export declare const MOCK_EXCLUDE_RE = "(\uD14C\uC2A4\uD2B8|test|vi\\.mock|jest\\.mock|spec\\.|\uD574\uC18C|\uC81C\uAC70|\uAC77\uC5B4|\uB300\uCCB4|\uAD50\uCCB4|\uB300\uC2E0|\uB77C\uC774\uBE0C|live|\uC2E4\uC81C\\s?(\uC2E4\uD589|\uB370\uC774\uD130|\uD658\uACBD)|\uC2E4\\s?(\uB370\uC774\uD130|\uC601\uC0C1|\uD658\uACBD)|\uC544\uB2C8|\uC54A|\uC5C6\uC774|\uC5C6\uC2B5\uB2C8\uB2E4|\uAE08\uC9C0|\uB8F0|\uADDC\uCE59|instead|real\\s|^\\s*\\|)";
30
33
  /**
31
34
  * "리뷰 생략" AND "다음으로 넘어감" 이 함께 있을 때만 발화하는 결합 트리거.
32
35
  * 두 lookahead 로 conjunction — 한쪽만 있는 경고/질문/신중 응답은 미발화(FP 0).
33
36
  */
34
- export declare const SKIP_REVIEW_TRIGGER_RE = "(?=[\\s\\S]*?(?:(\uB9AC\uBDF0|\uAC80\uD1A0)[^.!?\\n]{0,8}(\uC0DD\uB7B5|\uAC74\uB108\uB6F0|\uC5C6\uC774|\uC2A4\uD0B5|\uD328\uC2A4|\uC548\\s*\uD558\uACE0)|skip(?:ping|s)?\\s+(?:the\\s+)?review))(?=[\\s\\S]*?(?:\uB118\uC5B4\uAC00|\uB118\uC5B4\uAC11|\uB118\uC5B4\uAC14|\uB118\uC5B4\uAC10|\uB118\uC5B4\uAC08|\uB2E4\uC74C\\s*(\uC791\uC5C5|\uAE30\uB2A5|\uB2E8\uACC4|\uC2A4\uD15D|\uAC83|\uC774\uD130\uB808\uC774\uC158)|move\\s+on|next\\s+(step|task|feature)|proceed))";
37
+ export declare const SKIP_REVIEW_TRIGGER_RE = "^(?=[\\s\\S]*?(?:(\uB9AC\uBDF0|\uAC80\uD1A0)[^.!?\\n]{0,8}(\uC0DD\uB7B5|\uAC74\uB108\uB6F0|\uC5C6\uC774|\uC2A4\uD0B5|\uD328\uC2A4|\uC548\\s*\uD558\uACE0)|skip(?:ping|s)?\\s+(?:the\\s+)?review))(?=[\\s\\S]*?(?:\uB118\uC5B4\uAC00|\uB118\uC5B4\uAC11|\uB118\uC5B4\uAC14|\uB118\uC5B4\uAC10|\uB118\uC5B4\uAC08|\uB2E4\uC74C\\s*(\uC791\uC5C5|\uAE30\uB2A5|\uB2E8\uACC4|\uC2A4\uD15D|\uAC83|\uC774\uD130\uB808\uC774\uC158)|move\\s+on|next\\s+(step|task|feature)|proceed))";
35
38
  /**
36
39
  * critic-review 룰 트리거 = 완료 선언 OR 리뷰생략-넘어감.
37
40
  * (완료 시점 + skip 시점 양쪽에서 critic 강제. e2e/mock 룰엔 부여 안 함 — DEFAULT 만 사용.)
38
41
  */
39
- export declare const CRITIC_STOP_TRIGGER_RE = "((\uC644\uB8CC\uD588|\uC644\uC131\uB410|\uC644\uC131\uB418|\uC644\uC131\uD588|done\\.|ready\\.|shipped\\.|LGTM|finished\\.)|(?=[\\s\\S]*?(?:(\uB9AC\uBDF0|\uAC80\uD1A0)[^.!?\\n]{0,8}(\uC0DD\uB7B5|\uAC74\uB108\uB6F0|\uC5C6\uC774|\uC2A4\uD0B5|\uD328\uC2A4|\uC548\\s*\uD558\uACE0)|skip(?:ping|s)?\\s+(?:the\\s+)?review))(?=[\\s\\S]*?(?:\uB118\uC5B4\uAC00|\uB118\uC5B4\uAC11|\uB118\uC5B4\uAC14|\uB118\uC5B4\uAC10|\uB118\uC5B4\uAC08|\uB2E4\uC74C\\s*(\uC791\uC5C5|\uAE30\uB2A5|\uB2E8\uACC4|\uC2A4\uD15D|\uAC83|\uC774\uD130\uB808\uC774\uC158)|move\\s+on|next\\s+(step|task|feature)|proceed)))";
42
+ export declare const CRITIC_STOP_TRIGGER_RE = "((\uC644\uB8CC\uD588|\uC644\uC131\uB410|\uC644\uC131\uB418|\uC644\uC131\uD588|done\\.|ready\\.|shipped\\.|LGTM|finished\\.)|^(?=[\\s\\S]*?(?:(\uB9AC\uBDF0|\uAC80\uD1A0)[^.!?\\n]{0,8}(\uC0DD\uB7B5|\uAC74\uB108\uB6F0|\uC5C6\uC774|\uC2A4\uD0B5|\uD328\uC2A4|\uC548\\s*\uD558\uACE0)|skip(?:ping|s)?\\s+(?:the\\s+)?review))(?=[\\s\\S]*?(?:\uB118\uC5B4\uAC00|\uB118\uC5B4\uAC11|\uB118\uC5B4\uAC14|\uB118\uC5B4\uAC10|\uB118\uC5B4\uAC08|\uB2E4\uC74C\\s*(\uC791\uC5C5|\uAE30\uB2A5|\uB2E8\uACC4|\uC2A4\uD15D|\uAC83|\uC774\uD130\uB808\uC774\uC158)|move\\s+on|next\\s+(step|task|feature)|proceed)))";
40
43
  /**
41
44
  * critic 트리거 exclude — 기본 retraction + 부정/금지/질문형 + 숙고형 보강.
42
45
  * 주의: bare `안\s*하` 는 넣지 않는다 — "리뷰 안 하고 넘어감"(실제 skip TP)을 죽이므로.
@@ -44,3 +47,28 @@ export declare const CRITIC_STOP_TRIGGER_RE = "((\uC644\uB8CC\uD588|\uC644\uC131
44
47
  * 아니라 결정 전 단계라 배제 (리뷰 SEV-3 (a)).
45
48
  */
46
49
  export declare const CRITIC_STOP_EXCLUDE_RE: string;
50
+ /** 완료 선언 — 기존 + 실제 한국어 완료 보고 어휘(끝냈/끝났습니다/마쳤/마무리했/완료됐…). */
51
+ export declare const COMPLETION_TRIGGER_V2_RE = "(\uC644\uB8CC\uD588|\uC644\uB8CC\uB410|\uC644\uB8CC\uB418\uC5C8|\uC644\uB8CC\uC785\uB2C8\uB2E4|\uC644\uC131\uB410|\uC644\uC131\uB418|\uC644\uC131\uD588|\uB05D\uB0C8|\uB05D\uB0AC\uC2B5\uB2C8\uB2E4|\uB9C8\uCCE4|\uB9C8\uBB34\uB9AC\uD588|done\\.|ready\\.|shipped\\.|LGTM|finished\\.)";
52
+ /**
53
+ * 청크 경계 증거 — 커밋 해시(숫자와 a-f 를 모두 포함, 단어 경계) 또는 커밋·PR 언급·배포 동사·리뷰 생략.
54
+ * critic 룰은 이것이 메시지에 있을 때만 판정한다(상태 보고·대기 알림 제외). 트리거 lookahead 가 아니라
55
+ * verifier 의 only_if 로 선형 검사(critic SEV-2: lookahead 결합은 30k자에서 2.8s).
56
+ * 'feedback'(숫자 없음)·'20261007'(a-f 없음) 은 해시가 아니다.
57
+ */
58
+ export declare const CHUNK_EVIDENCE_RE = "(\\b(?=[0-9a-f]*\\d)(?=[0-9a-f]*[a-f])[0-9a-f]{7,40}\\b|\uCEE4\uBC0B|commit|PR\\s?#?\\d+|\uCEE4\uBC0B\uD588|\uBA38\uC9C0\uD588|\uBC30\uD3EC\uD588|\uBC30\uD3EC\uAC00 \uB05D|\uD478\uC2DC\uD588|\uBC1C\uD589\uD588|\uB9B4\uB9AC\uC2A4\uD588|merged|committed|pushed|released|shipped|(\uB9AC\uBDF0|\uAC80\uD1A0)[^.!?\\n]{0,8}(\uC0DD\uB7B5|\uAC74\uB108\uB6F0|\uC5C6\uC774|\uC2A4\uD0B5|\uD328\uC2A4|\uC548\\s*\uD558\uACE0)|skip(?:ping|s)?\\s+(?:the\\s+)?review)";
59
+ /** critic 룰: 완료 선언 OR 커밋·머지·배포 OR (리뷰 생략 AND 넘어감). */
60
+ export declare const CRITIC_TRIGGER_V2_RE = "((\uC644\uB8CC\uD588|\uC644\uB8CC\uB410|\uC644\uB8CC\uB418\uC5C8|\uC644\uB8CC\uC785\uB2C8\uB2E4|\uC644\uC131\uB410|\uC644\uC131\uB418|\uC644\uC131\uD588|\uB05D\uB0C8|\uB05D\uB0AC\uC2B5\uB2C8\uB2E4|\uB9C8\uCCE4|\uB9C8\uBB34\uB9AC\uD588|done\\.|ready\\.|shipped\\.|LGTM|finished\\.)|\uCEE4\uBC0B\uD588|\uBA38\uC9C0\uD588|\uBC30\uD3EC\uD588|\uBC30\uD3EC\uAC00 \uB05D|\uD478\uC2DC\uD588|\uBC1C\uD589\uD588|\uB9B4\uB9AC\uC2A4\uD588|merged|committed|pushed|released|shipped|^(?=[\\s\\S]*?(?:(\uB9AC\uBDF0|\uAC80\uD1A0)[^.!?\\n]{0,8}(\uC0DD\uB7B5|\uAC74\uB108\uB6F0|\uC5C6\uC774|\uC2A4\uD0B5|\uD328\uC2A4|\uC548\\s*\uD558\uACE0)|skip(?:ping|s)?\\s+(?:the\\s+)?review))(?=[\\s\\S]*?(?:\uB118\uC5B4\uAC00|\uB118\uC5B4\uAC11|\uB118\uC5B4\uAC14|\uB118\uC5B4\uAC10|\uB118\uC5B4\uAC08|\uB2E4\uC74C\\s*(\uC791\uC5C5|\uAE30\uB2A5|\uB2E8\uACC4|\uC2A4\uD15D|\uAC83|\uC774\uD130\uB808\uC774\uC158)|move\\s+on|next\\s+(step|task|feature)|proceed)))";
61
+ /** mock 룰: 단어가 아니라 "그걸로 검증/통과했다"는 **주장**. 순서 양방향, 한 문장(40자) 안. */
62
+ export declare const MOCK_CLAIM_TRIGGER_RE = "((mock|stub|fake|\uBAA9\\s?\uAC1D\uCCB4|\uC2A4\uD141)[^.!?\\n]{0,40}(\uAC80\uC99D|\uD1B5\uACFC|\uD655\uC778\uD588|\uD655\uC778\uB410|\uD14C\uC2A4\uD2B8\\s?(\uD588|\uB410|\uC644\uB8CC)|verified|passed|green)|(\uAC80\uC99D|\uD1B5\uACFC|verified|passed)[^.!?\\n]{0,40}(mock|stub|fake|\uBAA9\\s?\uAC1D\uCCB4|\uC2A4\uD141))";
63
+ /** 격리 검증 룰: 실 데이터·프로덕션·live 에 대고 **돌렸다**는 주장. */
64
+ export declare const LIVE_RUN_TRIGGER_RE = "((\uC2E4\\s?(\uB370\uC774\uD130|\uD658\uACBD|\uD648|\uCFFC\uD130|\uC138\uC158)|\uD504\uB85C\uB355\uC158|\uC6B4\uC601\\s?\uD658\uACBD|live|\uB77C\uC774\uBE0C|~\\/\\.forgen|~\\/\\.claude)[^.!?\\n]{0,40}(\uB3CC\uB838|\uC2E4\uD589\uD588|\uC801\uC6A9\uD588|\uAC80\uC99D\uD588|\uBC18\uC601\uD588|ran|executed|applied))";
65
+ /**
66
+ * 구현 먼저 금지 룰: **합의 없이 바로 구현했다**는 보고 — "바로/먼저/일단 구현했", "구현부터 했".
67
+ * 일반 구현 보고("구현했습니다")까지 걸면 30일 실측 5.8% 턴에서 자기 신고 루프가 돌아 노이즈만 늘었다.
68
+ * 결정 문서·합의 언급이 메시지에 있으면 준수로 본다(부정 lookahead).
69
+ */
70
+ export declare const IMPL_REPORT_TRIGGER_RE = "^(?![\\s\\S]*(\uACB0\uC815\\s?\uBB38\uC11C|docs\\/decisions|ADR-\\d|\uD569\uC758(\uD55C|\uB41C|\uD588|\uB97C\\s?\uAC70)|decision\\s+doc))[\\s\\S]*?((\uBC14\uB85C|\uBA3C\uC800|\uACE7\uBC14\uB85C|\uC77C\uB2E8|\uC6B0\uC120)\\s?(\uAD6C\uD604|\uCF54\uB4DC\\s?(\uB97C\\s?)?(\uC218\uC815|\uC791\uC131|\uBCC0\uACBD))(\uD588|\uD574\\s?(\uB480|\uB1A8|\uBC84\uB838))|\uAD6C\uD604\uBD80\uD130\\s?(\uD588|\uC9C4\uD589\uD588|\uC2DC\uC791\uD588))";
71
+ /** 기능을 빼는/보류하는 제안 어휘 — 주제 룰 결합용. */
72
+ export declare const DROP_PROPOSAL_RE = "\uBE7C(\uC790|\uB294\\s?\uAC8C|\uACE0|\uAE30\uB85C|\uBA74|\uACA0|\uB3C4\\s?\uB420|\uC57C)|\uBE84|\uC81C\uC678(\uD558\uC790|\uD558\uACE0|\uD558\uB294\\s?\uAC8C|\uD560|\uD558\uBA74|\uD569\uB2C8\uB2E4|\uD588|\uD558\uAE30\uB85C)|\uB4DC\uB86D|\uBBF8\uB8E8(\uC790|\uB294\\s?\uAC8C|\uACE0|\uAE30\uB85C)|drop|remove|defer";
73
+ /** 주제 룰: 룰이 명시한 기능 이름(topics) 중 하나 AND 빼기 제안. */
74
+ export declare function topicDropTrigger(topics: string[]): string;
@@ -25,8 +25,12 @@ export const DEFAULT_STOP_TRIGGER_RE = '(완료했|완성됐|완성되|완성했
25
25
  export const DEFAULT_STOP_EXCLUDE_RE = '(취소|철회|없음|없습니다|않았|하지\\s*않|아닙니다|not\\s*yet|no\\s*longer|retract|withdraw|아직\\s*(안|아))';
26
26
  /** mock/stub/fake 감지 — R-B2 전용 pattern (자가검증 주장 차단). */
27
27
  export const MOCK_TRIGGER_RE = '(mock|stub|fake)';
28
- /** mock trigger 의 exclude — 테스트 맥락은 정상. */
29
- export const MOCK_EXCLUDE_RE = '(테스트|test|vi\\.mock|jest\\.mock|spec\\.)';
28
+ /**
29
+ * mock trigger 의 exclude — 테스트 맥락은 정상. 2026-10-07: 문장 단위 판정으로 바뀌며 추가 —
30
+ * mock 을 **벗어나는** 서술(해소·제거·대체·라이브로 재검증·실제 실행·아님)은 위반 주장이 아니다(실측 오탐 예시 근거).
31
+ */
32
+ export const MOCK_EXCLUDE_RE = '(테스트|test|vi\\.mock|jest\\.mock|spec\\.|해소|제거|걷어|대체|교체|대신|라이브|live|실제\\s?(실행|데이터|환경)|실\\s?(데이터|영상|환경)|아니|않|없이|없습니다|금지|룰|규칙|instead|real\\s|^\\s*\\|)';
33
+ // ↑ `^\s*\|`: 마크다운 표 행 — 문장 단위 판정에서 행 하나가 한 문장이라, 룰 이름을 표 칸에 적은 것만으로 걸리던 오탐(v0.6.7 실사용).
30
34
  // ── critic-review 룰 전용 트리거 (2026-07-22) ─────────────────────────────────
31
35
  /** "리뷰/검토 생략" 시그널 (한/영). 외래어(스킵/패스)·구어(안 하고) 포함 — 리뷰 SEV-3 (a). */
32
36
  const REVIEW_SKIP = '(리뷰|검토)[^.!?\\n]{0,8}(생략|건너뛰|없이|스킵|패스|안\\s*하고)|skip(?:ping|s)?\\s+(?:the\\s+)?review';
@@ -36,7 +40,8 @@ const MOVE_ON = '넘어가|넘어갑|넘어갔|넘어감|넘어갈|다음\\s*(
36
40
  * "리뷰 생략" AND "다음으로 넘어감" 이 함께 있을 때만 발화하는 결합 트리거.
37
41
  * 두 lookahead 로 conjunction — 한쪽만 있는 경고/질문/신중 응답은 미발화(FP 0).
38
42
  */
39
- export const SKIP_REVIEW_TRIGGER_RE = `(?=[\\s\\S]*?(?:${REVIEW_SKIP}))(?=[\\s\\S]*?(?:${MOVE_ON}))`;
43
+ // 2026-10-07: `^` 고정 — 없으면 엔진이 모든 시작 위치에서 lookahead 를 다시 훑어 O(n²)(40k자 1s). m 플래그 없이 쓰므로 메시지 시작 1회만.
44
+ export const SKIP_REVIEW_TRIGGER_RE = `^(?=[\\s\\S]*?(?:${REVIEW_SKIP}))(?=[\\s\\S]*?(?:${MOVE_ON}))`;
40
45
  /**
41
46
  * critic-review 룰 트리거 = 완료 선언 OR 리뷰생략-넘어감.
42
47
  * (완료 시점 + skip 시점 양쪽에서 critic 강제. e2e/mock 룰엔 부여 안 함 — DEFAULT 만 사용.)
@@ -50,3 +55,40 @@ export const CRITIC_STOP_TRIGGER_RE = `(${DEFAULT_STOP_TRIGGER_RE}|${SKIP_REVIEW
50
55
  */
51
56
  export const CRITIC_STOP_EXCLUDE_RE = '(?:' + DEFAULT_STOP_EXCLUDE_RE +
52
57
  '|말고|마세요|말라|안\\s*했|안\\s*해|안\\s*할|안\\s*돼|안\\s*됩|하세요|반드시|위험|should\\s*not|shouldn|don.?t|될까요|까요\\?|할지|갈지|여부|고민|결정하)';
58
+ // ── 2026-10-07 룰별 발동 조건 분리 (30일 대화 2,216턴 실측 근거) ─────────────────────────
59
+ // 실측: 모든 완료 룰이 같은 완료 어휘에 반응해 (a) 실제 답변("끝났습니다")엔 거의 안 걸리고(1.4%)
60
+ // (b) 걸릴 땐 룰 4개가 동시에 걸렸으며 (c) mock 룰은 단어만 있어도 발동해 무한 반복(7회)했다.
61
+ // 각 룰은 그 룰이 지키려는 **행동의 주장**에만 반응한다.
62
+ /** 완료 선언 — 기존 + 실제 한국어 완료 보고 어휘(끝냈/끝났습니다/마쳤/마무리했/완료됐…). */
63
+ export const COMPLETION_TRIGGER_V2_RE = '(완료했|완료됐|완료되었|완료입니다|완성됐|완성되|완성했|끝냈|끝났습니다|마쳤|마무리했|done\\.|ready\\.|shipped\\.|LGTM|finished\\.)';
64
+ /** 작업 청크 종료(커밋·머지·배포) — critic 룰 전용. */
65
+ const SHIP_VERBS = '커밋했|머지했|배포했|배포가 끝|푸시했|발행했|릴리스했|merged|committed|pushed|released|shipped';
66
+ /**
67
+ * 청크 경계 증거 — 커밋 해시(숫자와 a-f 를 모두 포함, 단어 경계) 또는 커밋·PR 언급·배포 동사·리뷰 생략.
68
+ * critic 룰은 이것이 메시지에 있을 때만 판정한다(상태 보고·대기 알림 제외). 트리거 lookahead 가 아니라
69
+ * verifier 의 only_if 로 선형 검사(critic SEV-2: lookahead 결합은 30k자에서 2.8s).
70
+ * 'feedback'(숫자 없음)·'20261007'(a-f 없음) 은 해시가 아니다.
71
+ */
72
+ export const CHUNK_EVIDENCE_RE = `(\\b(?=[0-9a-f]*\\d)(?=[0-9a-f]*[a-f])[0-9a-f]{7,40}\\b|커밋|commit|PR\\s?#?\\d+|${SHIP_VERBS}|${REVIEW_SKIP})`;
73
+ /** critic 룰: 완료 선언 OR 커밋·머지·배포 OR (리뷰 생략 AND 넘어감). */
74
+ export const CRITIC_TRIGGER_V2_RE = `(${COMPLETION_TRIGGER_V2_RE}|${SHIP_VERBS}|${SKIP_REVIEW_TRIGGER_RE})`;
75
+ /** mock 룰: 단어가 아니라 "그걸로 검증/통과했다"는 **주장**. 순서 양방향, 한 문장(40자) 안. */
76
+ export const MOCK_CLAIM_TRIGGER_RE = '((mock|stub|fake|목\\s?객체|스텁)[^.!?\\n]{0,40}(검증|통과|확인했|확인됐|테스트\\s?(했|됐|완료)|verified|passed|green)|(검증|통과|verified|passed)[^.!?\\n]{0,40}(mock|stub|fake|목\\s?객체|스텁))';
77
+ /** 격리 검증 룰: 실 데이터·프로덕션·live 에 대고 **돌렸다**는 주장. */
78
+ export const LIVE_RUN_TRIGGER_RE = '((실\\s?(데이터|환경|홈|쿼터|세션)|프로덕션|운영\\s?환경|live|라이브|~\\/\\.forgen|~\\/\\.claude)[^.!?\\n]{0,40}(돌렸|실행했|적용했|검증했|반영했|ran|executed|applied))';
79
+ /**
80
+ * 구현 먼저 금지 룰: **합의 없이 바로 구현했다**는 보고 — "바로/먼저/일단 구현했", "구현부터 했".
81
+ * 일반 구현 보고("구현했습니다")까지 걸면 30일 실측 5.8% 턴에서 자기 신고 루프가 돌아 노이즈만 늘었다.
82
+ * 결정 문서·합의 언급이 메시지에 있으면 준수로 본다(부정 lookahead).
83
+ */
84
+ export const IMPL_REPORT_TRIGGER_RE = '^(?![\\s\\S]*(결정\\s?문서|docs\\/decisions|ADR-\\d|합의(한|된|했|를\\s?거)|decision\\s+doc))[\\s\\S]*?((바로|먼저|곧바로|일단|우선)\\s?(구현|코드\\s?(를\\s?)?(수정|작성|변경))(했|해\\s?(뒀|놨|버렸))|구현부터\\s?(했|진행했|시작했))';
85
+ /** 기능을 빼는/보류하는 제안 어휘 — 주제 룰 결합용. */
86
+ // 명사로 쓰이는 '보류'(라벨 값)·'삭제'(기능 설명)는 실측 오탐이라 제외하고, 제안·결정 활용형만 본다.
87
+ export const DROP_PROPOSAL_RE = '빼(자|는\\s?게|고|기로|면|겠|도\\s?될|야)|뺄|제외(하자|하고|하는\\s?게|할|하면|합니다|했|하기로)|드롭|미루(자|는\\s?게|고|기로)|drop|remove|defer';
88
+ /** 주제 룰: 룰이 명시한 기능 이름(topics) 중 하나 AND 빼기 제안. */
89
+ export function topicDropTrigger(topics) {
90
+ const esc = topics.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/\s+/g, '\\s*'));
91
+ // 같은 문장(60자 안)에서 기능 이름과 빼기 제안이 함께 나올 때만 — 메시지 전체 결합은 실측에서 무관한 응답을 잡았다.
92
+ const t = `(?:${esc.join('|')})`;
93
+ return `(${t}[^.!?\\n]{0,60}(?:${DROP_PROPOSAL_RE})|(?:${DROP_PROPOSAL_RE})[^.!?\\n]{0,60}${t})`;
94
+ }
@@ -20,7 +20,7 @@
20
20
  */
21
21
  import type { Rule } from '../store/types.js';
22
22
  interface VerifierSpec {
23
- kind: 'self_check_prompt' | 'artifact_check' | 'tool_arg_regex';
23
+ kind: 'self_check_prompt' | 'artifact_check' | 'tool_arg_regex' | 'tool_evidence' | 'language_ratio';
24
24
  params: Record<string, string | number | boolean>;
25
25
  }
26
26
  interface SpikeRule {
@@ -56,7 +56,7 @@ interface SpikeRule {
56
56
  */
57
57
  export declare function rulesFromStore(rules: Rule[]): SpikeRule[];
58
58
  /** Pure core — 단위 테스트용. stdin/IO 없음. */
59
- export declare function evaluateStop(lastAssistantMessage: string, rules: SpikeRule[]): {
59
+ export declare function evaluateStop(lastAssistantMessage: string, rules: SpikeRule[], recentTools?: string[]): {
60
60
  action: 'approve';
61
61
  hit: null;
62
62
  passed: string[];
@@ -90,7 +90,7 @@ export function rulesFromStore(rules) {
90
90
  continue;
91
91
  if (!spec.verifier)
92
92
  continue;
93
- if (spec.verifier.kind !== 'self_check_prompt' && spec.verifier.kind !== 'artifact_check')
93
+ if (spec.verifier.kind !== 'self_check_prompt' && spec.verifier.kind !== 'artifact_check' && spec.verifier.kind !== 'tool_evidence' && spec.verifier.kind !== 'language_ratio')
94
94
  continue;
95
95
  out.push({
96
96
  id: rule.rule_id,
@@ -189,15 +189,90 @@ function messageTriggersRule(message, rule) {
189
189
  return false;
190
190
  if (!safeRegexTest(includeRes.regex, m))
191
191
  return false;
192
- if (t.context_exclude_regex) {
193
- const excludeRes = compileSafeRegex(t.context_exclude_regex, 'i');
194
- if (excludeRes.regex && safeRegexTest(excludeRes.regex, m))
195
- return false;
192
+ if (!t.context_exclude_regex)
193
+ return true;
194
+ const excludeRes = compileSafeRegex(t.context_exclude_regex, 'i');
195
+ if (!excludeRes.regex)
196
+ return true;
197
+ // 2026-10-07: 제외 조건은 **매칭이 일어난 문장**에만 적용한다. 이전엔 메시지 전체를 봐서 "끝났습니다. 실패는
198
+ // 없습니다" 처럼 다른 문장의 '없습니다' 때문에 정상 완료 보고의 67% 를 놓쳤다(30일 실측).
199
+ // 길이 0 매칭(lookahead 결합 트리거)은 문장을 특정할 수 없어 기존처럼 메시지 전체로 판단.
200
+ const sentences = matchedSentences(m, includeRes.regex);
201
+ if (sentences === null)
202
+ return !safeRegexTest(excludeRes.regex, m);
203
+ return sentences.some((s) => !safeRegexTest(excludeRes.regex, s));
204
+ }
205
+ /** 문장 경계 — 줄바꿈, 반각 마침표류(. ! ?) 뒤 공백, 전각 마침표류(。!?) 뒤. 마침표는 앞 문장에 속한다. */
206
+ // 전각 부호(。!?)는 일·중 표기에서 공백 없이 이어 쓰므로 공백 없이도 경계(critic 재검증 SEV-3).
207
+ const SENTENCE_BOUNDARY = /\r?\n|(?<=[.!?])[ \t]+|(?<=[。!?])[ \t]*/g;
208
+ /** 텍스트 상한 — safeRegexTest 와 같은 절단(긴 최종 보고에서 Stop 훅 timeout 방지). */
209
+ const SENTENCE_SCAN_MAX = 65536;
210
+ /**
211
+ * include 매칭마다 **매칭의 마지막 글자가 속한 문장**을 돌려준다. 길이 0 매칭만 있으면 null.
212
+ * (critic SEV-1: 이전 구현은 매칭 자체의 끝 '다. ' 를 경계로 오인해 빈 문장/다음 문장을 판정했다.)
213
+ */
214
+ function matchedSentences(raw, re) {
215
+ const text = raw.length > SENTENCE_SCAN_MAX ? raw.slice(0, SENTENCE_SCAN_MAX) : raw;
216
+ const bounds = [];
217
+ let from = 0;
218
+ for (const b of text.matchAll(SENTENCE_BOUNDARY)) {
219
+ const at = b.index ?? 0;
220
+ bounds.push([from, at]);
221
+ from = at + b[0].length;
222
+ }
223
+ bounds.push([from, text.length]);
224
+ const sentenceAt = (pos) => {
225
+ for (const [a, z] of bounds)
226
+ if (pos >= a && pos < z)
227
+ return text.slice(a, z);
228
+ return '';
229
+ };
230
+ const g = new RegExp(re.source, re.flags.includes('g') ? re.flags : `${re.flags}g`);
231
+ const out = [];
232
+ let sawNonEmpty = false;
233
+ let guard = 0;
234
+ for (let mm = g.exec(text); mm && guard < 50; mm = g.exec(text), guard++) {
235
+ if (mm[0].length === 0) {
236
+ g.lastIndex++;
237
+ continue;
238
+ }
239
+ sawNonEmpty = true;
240
+ out.push(sentenceAt(mm.index + mm[0].length - 1));
196
241
  }
197
- return true;
242
+ return sawNonEmpty ? out : null;
198
243
  }
199
- function evaluateVerifier(rule) {
244
+ function evaluateVerifier(rule, recentTools = [], message = '') {
200
245
  const v = rule.verifier;
246
+ // 2026-10-07: 언어 룰 — 코드·URL·경로를 뺀 본문 글자 중 한글 비율. 기준 미달이면 위반.
247
+ if (v.kind === 'language_ratio') {
248
+ const body = message.replace(/```[\s\S]*?```/g, ' ').replace(/`[^`]*`/g, ' ').replace(/https?:\/\/\S+/g, ' ').replace(/[~./\\][\w./\\-]+/g, ' ');
249
+ const letters = body.match(/[A-Za-z가-힣]/g) ?? [];
250
+ if (letters.length < 20)
251
+ return { violated: false, reason: '' };
252
+ const hangul = letters.filter((c) => /[가-힣]/.test(c)).length;
253
+ const ratio = hangul / letters.length;
254
+ const min = Number(v.params.min_ratio ?? 0.5);
255
+ return ratio >= min ? { violated: false, reason: '' } : { violated: true, reason: String(v.params.question ?? '한국어로 다시 답하라.') };
256
+ }
257
+ // 2026-10-07: 자기 신고("위반 없음") 대신 실행 기록으로 판정 — 최근 도구 호출에 지정 도구가 있으면 통과.
258
+ // (critic 룰: 30일 실측에서 차단 후 실제 critic 실행 29%, 말로만 통과 29%.)
259
+ if (v.kind === 'tool_evidence') {
260
+ const want = String(v.params.tools ?? 'Agent,Task,Workflow').split(',').map((s) => s.trim()).filter(Boolean);
261
+ const window = Number(v.params.window ?? 60);
262
+ // 도구 기록이 아예 없으면(기록하지 않는 호스트·세션 id 불명) 판정 불가 → 통과(fail-open). 증거 부재와 기록 부재를 구분.
263
+ if (recentTools.length === 0)
264
+ return { violated: false, reason: '' };
265
+ // 청크 경계 증거(커밋 해시·커밋·배포 등)가 메시지에 없으면 이 룰의 대상(청크 완료)이 아니다 — 정규식 lookahead 대신 선형 검사.
266
+ if (typeof v.params.only_if === 'string') {
267
+ const only = compileSafeRegex(v.params.only_if, 'i');
268
+ if (only.regex && !safeRegexTest(only.regex, message))
269
+ return { violated: false, reason: '' };
270
+ }
271
+ const tail = recentTools.slice(-window);
272
+ if (tail.some((t) => want.includes(t)))
273
+ return { violated: false, reason: '' };
274
+ return { violated: true, reason: String(v.params.question ?? rule.block_message ?? `최근 작업에 ${want.join('/')} 실행 기록이 없음`) };
275
+ }
201
276
  if (v.kind === 'self_check_prompt') {
202
277
  const q = String(v.params.question ?? rule.block_message ?? '자가점검 필요');
203
278
  // self_check_prompt 는 증거가 없으면(artifact path 미지정/미존재) 위반 간주.
@@ -278,7 +353,7 @@ function artifactFresh(relOrAbs, maxAgeS) {
278
353
  }
279
354
  }
280
355
  /** Pure core — 단위 테스트용. stdin/IO 없음. */
281
- export function evaluateStop(lastAssistantMessage, rules) {
356
+ export function evaluateStop(lastAssistantMessage, rules, recentTools = []) {
282
357
  // ADR-017 D2: 실제 평가돼 통과한 룰(passed)과, D1 advise 강등으로 차단 대신 기록만 하는 룰(advised)을 함께 반환.
283
358
  const passed = [];
284
359
  const advised = [];
@@ -287,7 +362,7 @@ export function evaluateStop(lastAssistantMessage, rules) {
287
362
  continue;
288
363
  if (!messageTriggersRule(lastAssistantMessage, rule))
289
364
  continue;
290
- const result = evaluateVerifier(rule);
365
+ const result = evaluateVerifier(rule, recentTools, lastAssistantMessage);
291
366
  if (result.violated) {
292
367
  if (rule.enforce_mode === 'advise') {
293
368
  advised.push({ rule, reason: result.reason });
@@ -550,8 +625,8 @@ export async function main() {
550
625
  console.log(approveWithOptionalExtractionNotice());
551
626
  return;
552
627
  }
553
- const result = evaluateStop(lastMessage, rules);
554
628
  const sessionId = input?.session_id ?? 'unknown';
629
+ const result = evaluateStop(lastMessage, rules, loadRecentToolNames(sessionId));
555
630
  // ADR-017 D2: 실제 평가된 룰의 통과를 checks.jsonl 에 기록(violations 와 분리). D1: advise 강등 룰의
556
631
  // 위반은 kind:'correction' 으로 기록만 하고 차단하지 않는다.
557
632
  for (const id of result.passed)
@@ -32,6 +32,12 @@ export declare function appendRule(rule: Rule): Promise<{
32
32
  }>;
33
33
  export declare function loadRule(ruleId: string): Rule | null;
34
34
  export declare function loadAllRules(): Rule[];
35
+ /**
36
+ * 현재 프로젝트 cwd 의 `.forgen/rules/` 경로. FORGEN_CWD/COMPOUND_CWD 우선.
37
+ * 테스트 / CI 에서 프로젝트 스코프 로딩을 비활성화하려면 FORGEN_DISABLE_PROJECT_RULES=1.
38
+ */
39
+ /** 이 룰을 덮어쓰는 프로젝트 룰 파일(<cwd>/.forgen/rules/<id>.json)이 있으면 그 경로. 없으면 null. */
40
+ export declare function projectRuleOverridePath(ruleId: string): string | null;
35
41
  export declare function loadActiveRules(): Rule[];
36
42
  /**
37
43
  * render_key(+source, +scope)로 기존 rule을 찾는다 — status 무관(active/suppressed/removed/
@@ -155,6 +155,14 @@ function isCompatibleSchema(rule, filename) {
155
155
  * 현재 프로젝트 cwd 의 `.forgen/rules/` 경로. FORGEN_CWD/COMPOUND_CWD 우선.
156
156
  * 테스트 / CI 에서 프로젝트 스코프 로딩을 비활성화하려면 FORGEN_DISABLE_PROJECT_RULES=1.
157
157
  */
158
+ /** 이 룰을 덮어쓰는 프로젝트 룰 파일(<cwd>/.forgen/rules/<id>.json)이 있으면 그 경로. 없으면 null. */
159
+ export function projectRuleOverridePath(ruleId) {
160
+ const dir = resolveProjectRulesDir();
161
+ if (!dir)
162
+ return null;
163
+ const p = path.join(dir, `${ruleId}.json`);
164
+ return fs.existsSync(p) ? p : null;
165
+ }
158
166
  function resolveProjectRulesDir() {
159
167
  if (process.env.FORGEN_DISABLE_PROJECT_RULES === '1')
160
168
  return null;
@@ -17,7 +17,11 @@ export type RuleSource = 'onboarding' | 'explicit_correction' | 'behavior_infere
17
17
  export type RuleStatus = 'active' | 'suppressed' | 'removed' | 'superseded';
18
18
  export type EnforcementMech = 'A' | 'B' | 'C';
19
19
  export type HookPoint = 'PreToolUse' | 'PostToolUse' | 'Stop' | 'UserPromptSubmit';
20
- export type VerifierKind = 'file_exists' | 'pattern_match' | 'tool_arg_regex' | 'artifact_check' | 'self_check_prompt';
20
+ export type VerifierKind = 'file_exists' | 'pattern_match' | 'tool_arg_regex' | 'artifact_check' | 'self_check_prompt'
21
+ /** 2026-10-07: 최근 도구 호출 기록에 지정 도구(params.tools)가 있으면 통과 — 자기 신고 대신 실행 증거. */
22
+ | 'tool_evidence'
23
+ /** 2026-10-07: 응답의 문자 비율(params.script='hangul', min_ratio)로 언어 룰을 기계 판정. */
24
+ | 'language_ratio';
21
25
  export interface VerifierSpec {
22
26
  kind: VerifierKind;
23
27
  /** 각 kind 별로 의미가 다름 — 예: self_check_prompt 는 `question`, artifact_check 는 `path`+`max_age_s`. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wooojin/forgen",
3
- "version": "0.6.6",
3
+ "version": "0.6.8",
4
4
  "preferGlobal": true,
5
5
  "main": "dist/lib.js",
6
6
  "types": "./dist/lib.d.ts",
package/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://claude.ai/schemas/claude-plugin.json",
3
3
  "name": "forgen",
4
- "version": "0.6.6",
4
+ "version": "0.6.8",
5
5
  "description": "Claude Code harness — the more you use Claude, the better it gets",
6
6
  "author": {
7
7
  "name": "jang-ujin",
@@ -1035,6 +1035,24 @@ async function main() {
1035
1035
  }
1036
1036
  } catch { /* dist 없음(dev) 또는 실패 — 다음 forgen install codex 가 처리 */ }
1037
1037
 
1038
+ // ── 2.4b. Stop 룰 발동 조건 재조정 1회 마이그레이션 (2026-10-07, v0.6.7~) ──
1039
+ // 룰별 발동 조건·critic 실행 증거 판정은 룰 파일에 구워져 있어 업그레이드만으론 반영되지 않는다.
1040
+ // 사용자 룰만 대상(프로젝트 룰은 git 소스라 건드리지 않음). 마커로 1회만.
1041
+ try {
1042
+ const forgenHome = process.env.FORGEN_HOME || join(HOME, '.forgen');
1043
+ // v2(0.6.8): mock 제외에 표 행 추가 — 트리거가 바뀌면 마커 버전을 올려야 재적용된다.
1044
+ const marker = join(forgenHome, 'state', 'stop-retune-v2.done');
1045
+ if (existsSync(join(forgenHome, 'me', 'rules')) && !existsSync(marker)) {
1046
+ process.env.FORGEN_HOME = forgenHome;
1047
+ process.env.FORGEN_DISABLE_PROJECT_RULES = '1';
1048
+ const mod = await import(join(PKG_ROOT, 'dist', 'engine', 'enforce-classifier.js'));
1049
+ const n = await mod.applyStopRetuneToUserRules();
1050
+ mkdirSync(join(forgenHome, 'state'), { recursive: true });
1051
+ writeFileSync(marker, `${new Date().toISOString()} changed=${n}\n`);
1052
+ if (n > 0) console.log(`[forgen] Stop rules retuned: ${n} rule(s) now fire on their own claim (forgen rule classify --stop-only to review).`);
1053
+ }
1054
+ } catch (err) { console.error(`[forgen] Stop rule retune skipped: ${err?.message ?? err}`); }
1055
+
1038
1056
  // ── 2.5. statusLine 자동 등록 (settings 단일 쓰기에 포함) ──
1039
1057
  let statusLineResult = 'unchanged';
1040
1058
  try { statusLineResult = applyStatusLineAuto(settings); } catch (err) { console.error(`[forgen] statusLine setup skipped: ${err?.message ?? err}`); }