@wooojin/forgen 0.6.5 → 0.6.7

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.
Files changed (58) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/CHANGELOG.md +41 -0
  3. package/README.ja.md +2 -1
  4. package/README.ko.md +2 -1
  5. package/README.md +2 -1
  6. package/README.zh.md +2 -1
  7. package/dist/cli.js +2 -2
  8. package/dist/core/block-cli.js +2 -4
  9. package/dist/core/dashboard.js +1 -1
  10. package/dist/core/explain-cli.js +3 -28
  11. package/dist/core/rate-limit-forecast.js +7 -1
  12. package/dist/core/state-gc.d.ts +14 -0
  13. package/dist/core/state-gc.js +47 -4
  14. package/dist/core/stats-cli.js +5 -5
  15. package/dist/core/statusline-cli.d.ts +24 -2
  16. package/dist/core/statusline-cli.js +125 -23
  17. package/dist/core/statusline-install.d.ts +8 -1
  18. package/dist/core/statusline-install.js +34 -3
  19. package/dist/engine/block-judge.js +4 -5
  20. package/dist/engine/classify-enforce-cli.js +40 -0
  21. package/dist/engine/context-signals.d.ts +20 -0
  22. package/dist/engine/context-signals.js +102 -0
  23. package/dist/engine/correction-cluster-runner.d.ts +3 -3
  24. package/dist/engine/correction-cluster-runner.js +48 -12
  25. package/dist/engine/correction-clustering.d.ts +27 -0
  26. package/dist/engine/correction-clustering.js +79 -3
  27. package/dist/engine/enforce-classifier.d.ts +28 -1
  28. package/dist/engine/enforce-classifier.js +90 -19
  29. package/dist/engine/ko-colloquial.d.ts +13 -0
  30. package/dist/engine/ko-colloquial.js +45 -0
  31. package/dist/engine/lifecycle/lifecycle-cli.js +25 -5
  32. package/dist/engine/lifecycle/meta-reclassifier.d.ts +1 -0
  33. package/dist/engine/lifecycle/meta-reclassifier.js +3 -21
  34. package/dist/engine/lifecycle/rotated-logs.d.ts +18 -0
  35. package/dist/engine/lifecycle/rotated-logs.js +67 -0
  36. package/dist/engine/lifecycle/signals.d.ts +27 -1
  37. package/dist/engine/lifecycle/signals.js +55 -32
  38. package/dist/engine/lifecycle/types.d.ts +5 -0
  39. package/dist/engine/match-eval-log.d.ts +2 -0
  40. package/dist/engine/match-eval-log.js +1 -0
  41. package/dist/engine/ranking-pipeline.d.ts +9 -1
  42. package/dist/engine/ranking-pipeline.js +24 -2
  43. package/dist/engine/solution-format.d.ts +2 -0
  44. package/dist/engine/solution-format.js +6 -2
  45. package/dist/engine/solution-matcher.d.ts +5 -1
  46. package/dist/engine/solution-matcher.js +4 -2
  47. package/dist/hooks/post-tool-use.js +3 -1
  48. package/dist/hooks/shared/stop-triggers.d.ts +32 -4
  49. package/dist/hooks/shared/stop-triggers.js +44 -3
  50. package/dist/hooks/solution-injector.js +7 -2
  51. package/dist/hooks/stop-guard.d.ts +2 -2
  52. package/dist/hooks/stop-guard.js +85 -10
  53. package/dist/store/rule-store.d.ts +16 -0
  54. package/dist/store/rule-store.js +34 -2
  55. package/dist/store/types.d.ts +5 -1
  56. package/package.json +1 -1
  57. package/plugin.json +1 -1
  58. package/scripts/postinstall.js +23 -2
@@ -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');
@@ -0,0 +1,13 @@
1
+ /**
2
+ * 한국어 회화체 잔여물 처리 — extractTags 의 한국어 분기 전처리.
3
+ *
4
+ * 문제: "이거 같아 왜냐면 시켜보자" 같은 회화체 프롬프트에서 extractTags 가 8칸을 어미/지시어/접속어로
5
+ * 채워 실제 주제어가 밀려난다(ADR-017 §1.5a 실측). KO_STOPWORDS 는 문서체 명사 위주라 이를 못 거른다.
6
+ *
7
+ * 처리 (결과는 `string | null`):
8
+ * - 순수 구어(지시어·접속어·종결 어미·"같아" 류) → null (드롭)
9
+ * - 명사+구어 어미 ("검증해줘", "가능한", "배포하는지") → 어간만 남김 ("검증", "가능", "배포")
10
+ * - 그 외 → 원문 그대로
11
+ * 어간이 2자 미만이면 어미 제거를 하지 않는다("이해"→"이" 방지).
12
+ */
13
+ export declare function normalizeColloquialKo(word: string): string | null;
@@ -0,0 +1,45 @@
1
+ /**
2
+ * 한국어 회화체 잔여물 처리 — extractTags 의 한국어 분기 전처리.
3
+ *
4
+ * 문제: "이거 같아 왜냐면 시켜보자" 같은 회화체 프롬프트에서 extractTags 가 8칸을 어미/지시어/접속어로
5
+ * 채워 실제 주제어가 밀려난다(ADR-017 §1.5a 실측). KO_STOPWORDS 는 문서체 명사 위주라 이를 못 거른다.
6
+ *
7
+ * 처리 (결과는 `string | null`):
8
+ * - 순수 구어(지시어·접속어·종결 어미·"같아" 류) → null (드롭)
9
+ * - 명사+구어 어미 ("검증해줘", "가능한", "배포하는지") → 어간만 남김 ("검증", "가능", "배포")
10
+ * - 그 외 → 원문 그대로
11
+ * 어간이 2자 미만이면 어미 제거를 하지 않는다("이해"→"이" 방지).
12
+ */
13
+ /** 순수 구어 — 단독으로 나오면 태그로 가치가 없다. */
14
+ const COLLOQUIAL_DROP = new Set([
15
+ // 종결·연결 어미 단독
16
+ '같아', '같은데', '같네', '같다', '같애', '같아서', '같은', '거야', '거예요', '건데', '인데', '는데', '은데',
17
+ '하는데', '했는데', '한데', '해줘', '해봐', '해라', '해요', '보자', '볼까', '할까', '할래', '줄래',
18
+ '시켜보자', '시켜봐', '시켜줘', '시켜', '알려줘', '말해줘', '맞아', '맞지', '아니야', '아니고', '아닌데',
19
+ '했는지', '하는지', '할지', '해야', '해야할', '해야하는', '위한', '대한', '통한', '관한', '진행해', '진행해줘',
20
+ // 접속·지시·대명사
21
+ '왜냐면', '왜냐하면', '그래서', '그러면', '그럼', '그런데', '근데', '그리고', '하지만', '그러나', '그래도',
22
+ '이거', '저거', '그거', '이게', '그게', '저게', '이건', '그건', '이걸', '그걸', '여기', '거기', '저기',
23
+ '지금', '이제', '우리', '어떤', '어떻게', '어디', '뭔가', '뭐든', '전부', '일단', '아무', '그냥', '좀더',
24
+ '혹시', '아직', '다시', '계속', '바로', '먼저', '나중', '그다음',
25
+ ]);
26
+ /**
27
+ * 어간 + 구어 어미. 긴 어미가 먼저 매칭되도록 정렬한다.
28
+ * 어간 그룹은 한글 2자 이상(lazy) — 1자 어간("이해"→"이")은 거부.
29
+ */
30
+ const COLLOQUIAL_ENDINGS = [
31
+ '해주세요', '해줄래', '해줘', '해봐', '해보자', '시켜보자', '시켜줘', '시켜봐',
32
+ '하는지', '했는지', '할지', '하는데', '했는데', '한데', '인데', '는데', '은데',
33
+ '하자', '해야', '해도', '하면', '해서', '했던', '하는',
34
+ // 1글자 어미('할/한/해')는 제거하지 않는다 — 권한·역할·제한·피해 같은 명사를 자른다(critic v0.6.6: 접근권한→접근권).
35
+ ].sort((a, b) => b.length - a.length);
36
+ const COLLOQUIAL_ENDING_RE = new RegExp(`^([가-힣]{2,}?)(${COLLOQUIAL_ENDINGS.join('|')})$`);
37
+ export function normalizeColloquialKo(word) {
38
+ if (COLLOQUIAL_DROP.has(word))
39
+ return null;
40
+ const m = word.match(COLLOQUIAL_ENDING_RE);
41
+ if (!m)
42
+ return word;
43
+ const stem = m[1];
44
+ return COLLOQUIAL_DROP.has(stem) ? null : stem;
45
+ }
@@ -5,9 +5,9 @@
5
5
  * default dry-run, --apply 시 rule 파일에 상태 전이 반영.
6
6
  */
7
7
  import * as path from 'node:path';
8
- import { loadAllRules, saveRule } from '../../store/rule-store.js';
8
+ import { loadAllRules, saveRule, syncRuleCounters } from '../../store/rule-store.js';
9
9
  import { STATE_DIR } from '../../core/paths.js';
10
- import { collectSignals, readJsonlSafe, isConfirmedBypass, isSyntheticSession } from './signals.js';
10
+ import { collectSignals, deriveRuleCounters, readViolationsWindow, ROTATED_KEEP_DAYS, isConfirmedBypass, isSyntheticEntry } from './signals.js';
11
11
  import { detect as detectT2 } from './trigger-t2-violation.js';
12
12
  import { detect as detectT3 } from './trigger-t3-bypass.js';
13
13
  import { detect as detectT4 } from './trigger-t4-decay.js';
@@ -23,11 +23,12 @@ export async function handleLifecycleScan(args) {
23
23
  console.log('\n No rules in ~/.forgen/me/rules. Nothing to scan.\n');
24
24
  return;
25
25
  }
26
- const violations = readJsonlSafe(path.join(STATE_DIR, 'enforcement', 'violations.jsonl'));
26
+ // 현재 파일 + 30일 창 안의 회전본 (rotateIfBig 직후에도 창 기록이 사라지지 않게).
27
+ const violations = readViolationsWindow(30, now);
27
28
  // ADR-017 D1: bypass.jsonl(자연어 휴리스틱, 전량 오탐)은 더 이상 읽지 않는다. T3 입력은
28
29
  // violations 의 kind:'bypass_confirmed'(사용자 명시 우회) 뿐이며 collectSignals 가 거기서 뽑는다.
29
30
  const bypassConfirmed = violations.filter(isConfirmedBypass).length;
30
- const syntheticExcluded = violations.filter((v) => isSyntheticSession(v.session_id)).length;
31
+ const syntheticExcluded = violations.filter((v) => isSyntheticEntry(v)).length;
31
32
  const drift = readDriftEntries();
32
33
  const signals = new Map();
33
34
  for (const r of rules)
@@ -42,8 +43,26 @@ export async function handleLifecycleScan(args) {
42
43
  const promotionCandidates = scanSignalsForPromotion({ rules, signals, ts: now });
43
44
  console.log(`\n Lifecycle Scan — ${rules.length} rule(s) (${apply ? 'APPLY' : 'dry-run'})\n`);
44
45
  console.log(` Signals: violations.jsonl=${violations.length} (synthetic-session excluded ${syntheticExcluded}) bypass_confirmed=${bypassConfirmed} drift.jsonl=${drift.length}\n`);
46
+ // 카운터 재계산 — 룰 JSON 의 violation_count/bypass_count 는 훅 경로가 갱신하지 않는 캐시라
47
+ // 로그(보존 범위 전체, 회전본 포함)에서 다시 계산한다. dry-run 은 차이만 보여준다.
48
+ const counters = deriveRuleCounters(readViolationsWindow(ROTATED_KEEP_DAYS, now));
49
+ const counterDiffs = rules.filter((r) => {
50
+ const c = counters.get(r.rule_id);
51
+ return (r.lifecycle?.violation_count ?? 0) !== (c?.violation_count ?? 0) || (r.lifecycle?.bypass_count ?? 0) !== (c?.bypass_count ?? 0);
52
+ });
53
+ console.log(` Counters: ${counterDiffs.length} rule(s) differ from logs (violation_count/bypass_count)${apply ? '' : ' — --apply 로 동기화'}\n`);
54
+ // Meta apply 가 원본 rule 객체로 다시 저장하므로 카운터 동기화는 항상 마지막에 한다.
55
+ const applyCounters = () => {
56
+ let n = 0;
57
+ for (const r of counterDiffs)
58
+ if (syncRuleCounters(r.rule_id, counters.get(r.rule_id) ?? { violation_count: 0, bypass_count: 0 }))
59
+ n++;
60
+ return n;
61
+ };
45
62
  if (events.length === 0 && demotionCandidates.length === 0 && promotionCandidates.length === 0) {
46
63
  console.log(' No lifecycle events. System stable.\n');
64
+ if (apply)
65
+ console.log(` Counters synced: ${applyCounters()} rule(s).\n`);
47
66
  return;
48
67
  }
49
68
  console.log(` Rule health events: ${events.length}`);
@@ -100,6 +119,7 @@ export async function handleLifecycleScan(args) {
100
119
  }
101
120
  if (metaEvents.length > 0)
102
121
  appendLifecycleEvents(metaEvents, now);
103
- console.log(`\n Applied: ${saved} rule(s) updated, ${metaEvents.length} health event(s).`);
122
+ const countersSynced = applyCounters();
123
+ console.log(`\n Applied: ${saved} rule(s) updated, ${metaEvents.length} health event(s), ${countersSynced} counter sync(s).`);
104
124
  console.log(` Log: ${LIFECYCLE_DIR}/${new Date(now).toISOString().slice(0, 10)}.jsonl\n`);
105
125
  }
@@ -35,6 +35,7 @@ export interface DemotionCandidate {
35
35
  window_days: number;
36
36
  current_mechs: EnforcementMech[];
37
37
  }
38
+ /** drift.jsonl 현재 파일 + 30일 창 안의 회전본. */
38
39
  export declare function readDriftEntries(driftPath?: string): DriftEntry[];
39
40
  export declare function scanDriftForDemotion(options?: {
40
41
  rules: Rule[];
@@ -20,6 +20,7 @@ import * as path from 'node:path';
20
20
  import { initLifecycle } from '../../store/rule-lifecycle.js';
21
21
  import { loadAllRules, saveRule } from '../../store/rule-store.js';
22
22
  import { STATE_DIR } from '../../core/paths.js';
23
+ import { readJsonlWindow } from './rotated-logs.js';
23
24
  const DRIFT_LOG_PATH = path.join(STATE_DIR, 'enforcement', 'drift.jsonl');
24
25
  const LIFECYCLE_DIR = path.join(STATE_DIR, 'lifecycle');
25
26
  const DEFAULT_WINDOW_DAYS = 7;
@@ -37,28 +38,9 @@ function isRecentlyClassified(rule, nowMs, cooldownMs) {
37
38
  return false;
38
39
  return nowMs - lastMs < cooldownMs;
39
40
  }
41
+ /** drift.jsonl 현재 파일 + 30일 창 안의 회전본. */
40
42
  export function readDriftEntries(driftPath = DRIFT_LOG_PATH) {
41
- if (!fs.existsSync(driftPath))
42
- return [];
43
- try {
44
- const raw = fs.readFileSync(driftPath, 'utf-8');
45
- return raw
46
- .trim()
47
- .split('\n')
48
- .filter(Boolean)
49
- .map((line) => {
50
- try {
51
- return JSON.parse(line);
52
- }
53
- catch {
54
- return null;
55
- }
56
- })
57
- .filter((e) => e !== null);
58
- }
59
- catch {
60
- return [];
61
- }
43
+ return readJsonlWindow(driftPath, 30);
62
44
  }
63
45
  export function scanDriftForDemotion(options = { rules: [] }) {
64
46
  const windowDays = options.windowDays ?? DEFAULT_WINDOW_DAYS;
@@ -0,0 +1,18 @@
1
+ /** 회전본 보존 상한 — state-gc 가 적용. 개수 3개 + 60일 중 먼저 닿는 쪽. */
2
+ export declare const ROTATED_KEEP_MAX = 3;
3
+ export declare const ROTATED_KEEP_DAYS = 60;
4
+ export interface RotatedFile {
5
+ path: string;
6
+ mtimeMs: number;
7
+ size: number;
8
+ }
9
+ /** `<p>.<timestamp>` 회전본을 mtime 오름차순(오래된 것 먼저)으로 나열. */
10
+ export declare function listRotated(p: string): RotatedFile[];
11
+ /**
12
+ * 최근 `days` 일 창을 덮는 로그 파일 경로들(오래된 순, 현재 파일이 마지막).
13
+ * 회전본은 mtime(=마지막 append≈회전 시각)이 창 안일 때만 포함 — 창 밖 회전본은 창 안 기록이 없다.
14
+ */
15
+ export declare function logFilesWithin(p: string, days: number, now?: number): string[];
16
+ /** 현재 파일 + 창 안 회전본을 이어 읽는다. 창 기반 리더(stats/explain/lifecycle/statusline)의 공용 진입점. */
17
+ export declare function readJsonlWindow<T>(p: string, days: number, now?: number): T[];
18
+ export declare function readJsonlSafe<T>(p: string): T[];
@@ -0,0 +1,67 @@
1
+ /**
2
+ * rotateIfBig 회전본(`<file>.<timestamp>`) 나열 — fs/path 만 쓰는 경량 모듈 (state-gc 등이 signals 의 무거운 import 없이 사용).
3
+ */
4
+ import * as fs from 'node:fs';
5
+ import * as path from 'node:path';
6
+ /** 회전본 접미사: rotateIfBig 가 붙이는 `Date.now()` 밀리초 타임스탬프. */
7
+ const ROTATED_SUFFIX_RE = /^\d{10,}$/;
8
+ /** 회전본 보존 상한 — state-gc 가 적용. 개수 3개 + 60일 중 먼저 닿는 쪽. */
9
+ export const ROTATED_KEEP_MAX = 3;
10
+ export const ROTATED_KEEP_DAYS = 60;
11
+ /** `<p>.<timestamp>` 회전본을 mtime 오름차순(오래된 것 먼저)으로 나열. */
12
+ export function listRotated(p) {
13
+ const dir = path.dirname(p);
14
+ const base = `${path.basename(p)}.`;
15
+ const out = [];
16
+ try {
17
+ for (const name of fs.readdirSync(dir)) {
18
+ if (!name.startsWith(base) || !ROTATED_SUFFIX_RE.test(name.slice(base.length)))
19
+ continue;
20
+ const full = path.join(dir, name);
21
+ try {
22
+ const st = fs.statSync(full);
23
+ if (st.isFile())
24
+ out.push({ path: full, mtimeMs: st.mtimeMs, size: st.size });
25
+ }
26
+ catch { /* raced away */ }
27
+ }
28
+ }
29
+ catch { /* dir missing */ }
30
+ return out.sort((a, b) => a.mtimeMs - b.mtimeMs);
31
+ }
32
+ /**
33
+ * 최근 `days` 일 창을 덮는 로그 파일 경로들(오래된 순, 현재 파일이 마지막).
34
+ * 회전본은 mtime(=마지막 append≈회전 시각)이 창 안일 때만 포함 — 창 밖 회전본은 창 안 기록이 없다.
35
+ */
36
+ export function logFilesWithin(p, days, now = Date.now()) {
37
+ const cutoff = now - days * 24 * 3600 * 1000;
38
+ const files = listRotated(p).filter((r) => r.mtimeMs >= cutoff).map((r) => r.path);
39
+ files.push(p);
40
+ return files;
41
+ }
42
+ /** 현재 파일 + 창 안 회전본을 이어 읽는다. 창 기반 리더(stats/explain/lifecycle/statusline)의 공용 진입점. */
43
+ export function readJsonlWindow(p, days, now = Date.now()) {
44
+ return logFilesWithin(p, days, now).flatMap((f) => readJsonlSafe(f));
45
+ }
46
+ export function readJsonlSafe(p) {
47
+ if (!fs.existsSync(p))
48
+ return [];
49
+ try {
50
+ return fs.readFileSync(p, 'utf-8')
51
+ .trim()
52
+ .split('\n')
53
+ .filter(Boolean)
54
+ .map((line) => {
55
+ try {
56
+ return JSON.parse(line);
57
+ }
58
+ catch {
59
+ return null;
60
+ }
61
+ })
62
+ .filter((e) => e !== null);
63
+ }
64
+ catch {
65
+ return [];
66
+ }
67
+ }
@@ -16,6 +16,9 @@ import type { Rule } from '../../store/types.js';
16
16
  */
17
17
  export declare function redactForReceipt(text: string): string;
18
18
  import type { RuleSignals, ViolationEntry, BypassEntry, VerdictEntry, CheckEntry } from './types.js';
19
+ import { listRotated, logFilesWithin, readJsonlSafe, readJsonlWindow, ROTATED_KEEP_MAX, ROTATED_KEEP_DAYS } from './rotated-logs.js';
20
+ export { listRotated, logFilesWithin, readJsonlSafe, readJsonlWindow, ROTATED_KEEP_MAX, ROTATED_KEEP_DAYS };
21
+ export type { RotatedFile } from './rotated-logs.js';
19
22
  /**
20
23
  * Best-effort size-based rotation. When `p` exceeds 10MB, renames to
21
24
  * `<p>.<timestamp>` so the next write starts fresh. Missing file or rename
@@ -24,7 +27,6 @@ import type { RuleSignals, ViolationEntry, BypassEntry, VerdictEntry, CheckEntry
24
27
  * this file (drift.jsonl, acknowledgments.jsonl) reuse the same policy.
25
28
  */
26
29
  export declare function rotateIfBig(p: string): void;
27
- export declare function readJsonlSafe<T>(p: string): T[];
28
30
  /**
29
31
  * ADR-017 §2 원칙 2: 훅이 session_id 없이 호출되면 'default'/'unknown' 폴백이 기록된다.
30
32
  * 실세션(Claude·Codex 모두 session_id 전달)에서는 나오지 않으며, 실측상 전부 테스트가
@@ -32,16 +34,27 @@ export declare function readJsonlSafe<T>(p: string): T[];
32
34
  */
33
35
  export declare const SYNTHETIC_SESSION_IDS: ReadonlySet<string>;
34
36
  export declare function isSyntheticSession(sessionId: unknown): boolean;
37
+ /** FORGEN_SYNTHETIC=1 (eval/probe 러너가 설정) 이면 기록에 synthetic:true 를 붙인다. */
38
+ export declare function syntheticStamp(): {
39
+ synthetic?: true;
40
+ };
41
+ /** 엔트리 단위 합성 판정: 명시적 synthetic 플래그 또는 합성 세션 id. */
42
+ export declare function isSyntheticEntry(e: {
43
+ synthetic?: unknown;
44
+ session_id?: unknown;
45
+ }): boolean;
35
46
  /** 사용자 관점의 "차단": block/deny (+legacy undefined). correction/bypass_confirmed 는 아님. */
36
47
  export declare function isBlockKind(kind: unknown): boolean;
37
48
  /** 실세션에서 일어난 실제 차단만. stats/explain/lifecycle 이 공유하는 단일 기준. */
38
49
  export declare function isRealBlock(e: {
39
50
  kind?: unknown;
40
51
  session_id?: unknown;
52
+ synthetic?: unknown;
41
53
  }): boolean;
42
54
  export declare function isConfirmedBypass(e: {
43
55
  kind?: unknown;
44
56
  session_id?: unknown;
57
+ synthetic?: unknown;
45
58
  }): boolean;
46
59
  export declare const RECEIPT_TTL_MS: number;
47
60
  export declare const MATCHED_MAX = 160;
@@ -54,9 +67,12 @@ export interface RecordViolationOptions {
54
67
  * 마스킹 후 전문을 24h TTL 영수증으로 남긴다(로그엔 hash 만). 실패해도 예외 없이 '' 반환.
55
68
  */
56
69
  export declare function recordViolation(entry: Omit<ViolationEntry, 'at'>, opts?: RecordViolationOptions): string;
70
+ /** 위반 로그(현재 + 창 안 회전본). 기본 30일 = collectSignals 창. */
71
+ export declare function readViolationsWindow(days?: number, now?: number): ViolationEntry[];
57
72
  export declare function readReceipt(violationId: string): string | null;
58
73
  /** 판정 기록(append-only). 같은 violation_id 에 여러 줄이면 마지막이 유효하되 user > auto. */
59
74
  export declare function setVerdict(entry: Omit<VerdictEntry, 'at'>): void;
75
+ /** 판정은 위반 이후에 기록되므로 30일 창(위반 조회 최대 창)이면 충분하다. */
60
76
  export declare function readVerdicts(): VerdictEntry[];
61
77
  /** violation_id → 유효 판정 (user 가 있으면 user, 없으면 마지막 auto). */
62
78
  export declare function effectiveVerdicts(verdicts?: VerdictEntry[]): Map<string, VerdictEntry>;
@@ -84,4 +100,14 @@ export interface SignalInputs {
84
100
  now?: number;
85
101
  }
86
102
  export declare function collectSignals(rule: Rule, inputs?: SignalInputs): RuleSignals;
103
+ /**
104
+ * 룰별 위반/우회 카운터를 로그에서 재계산 (lifecycle-scan --apply 가 룰 JSON 에 저장).
105
+ * 원천은 항상 로그다 — 룰 JSON 의 violation_count/bypass_count 는 이 값의 캐시일 뿐이며
106
+ * 보존된 로그 범위(회전본 포함) 안의 합계다. 훅 경로에서는 갱신하지 않는다.
107
+ */
108
+ export declare function deriveRuleCounters(violations: ViolationEntry[]): Map<string, {
109
+ violation_count: number;
110
+ bypass_count: number;
111
+ last_violation_at?: string;
112
+ }>;
87
113
  export declare function collectAllSignals(rules: Rule[], inputs?: SignalInputs): Map<string, RuleSignals>;