@wooojin/forgen 0.5.8 → 0.6.1
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.
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +102 -0
- package/README.ja.md +12 -0
- package/README.ko.md +12 -0
- package/README.md +12 -0
- package/README.zh.md +12 -0
- package/dist/checks/_shared/model-profile.d.ts +1 -1
- package/dist/checks/_shared/model-profile.js +9 -5
- package/dist/cli.js +32 -3
- package/dist/core/auto-compound-runner.js +20 -43
- package/dist/core/block-cli.d.ts +1 -0
- package/dist/core/block-cli.js +41 -0
- package/dist/core/explain-cli.js +29 -1
- package/dist/core/inspect-cli.js +9 -8
- package/dist/core/rate-limit-forecast.d.ts +113 -0
- package/dist/core/rate-limit-forecast.js +236 -0
- package/dist/core/state-gc.js +3 -0
- package/dist/core/stats-cli.d.ts +15 -0
- package/dist/core/stats-cli.js +50 -16
- package/dist/core/status-cli.d.ts +18 -1
- package/dist/core/status-cli.js +51 -2
- package/dist/core/statusline-cli.d.ts +58 -13
- package/dist/core/statusline-cli.js +164 -201
- package/dist/core/uninstall.js +10 -1
- package/dist/core/v1-bootstrap.js +7 -1
- package/dist/engine/block-judge-cli.d.ts +2 -0
- package/dist/engine/block-judge-cli.js +11 -0
- package/dist/engine/block-judge.d.ts +68 -0
- package/dist/engine/block-judge.js +248 -0
- package/dist/engine/correction-cluster-runner.d.ts +67 -0
- package/dist/engine/correction-cluster-runner.js +242 -5
- package/dist/engine/correction-clustering.d.ts +15 -0
- package/dist/engine/correction-clustering.js +24 -0
- package/dist/engine/lifecycle/lifecycle-cli.js +7 -4
- package/dist/engine/lifecycle/signals.d.ts +59 -2
- package/dist/engine/lifecycle/signals.js +193 -4
- package/dist/engine/lifecycle/trigger-t3-bypass.d.ts +5 -3
- package/dist/engine/lifecycle/trigger-t3-bypass.js +6 -4
- package/dist/engine/lifecycle/types.d.ts +29 -1
- package/dist/engine/mined-rule-merge-cli.d.ts +11 -0
- package/dist/engine/mined-rule-merge-cli.js +67 -0
- package/dist/engine/rule-relevance.d.ts +72 -0
- package/dist/engine/rule-relevance.js +183 -0
- package/dist/engine/rule-toggle-cli.d.ts +5 -0
- package/dist/engine/rule-toggle-cli.js +30 -0
- package/dist/fgx.js +1 -1
- package/dist/forge/evidence-processor.js +2 -0
- package/dist/hooks/post-tool-use.js +9 -14
- package/dist/hooks/pre-tool-use.js +71 -8
- package/dist/hooks/shared/command-parser.d.ts +11 -0
- package/dist/hooks/shared/command-parser.js +120 -0
- package/dist/hooks/solution-injector.js +13 -0
- package/dist/hooks/stop-guard.d.ts +18 -0
- package/dist/hooks/stop-guard.js +55 -10
- package/dist/host/install-claude.js +7 -33
- package/dist/host/install-codex.d.ts +23 -1
- package/dist/host/install-codex.js +128 -49
- package/dist/host/install-opencode.d.ts +5 -0
- package/dist/host/install-opencode.js +9 -6
- package/dist/host/managed-marker.d.ts +22 -0
- package/dist/host/managed-marker.js +79 -0
- package/dist/host/uninstall-codex.d.ts +2 -0
- package/dist/host/uninstall-codex.js +12 -9
- package/dist/host/uninstall-opencode.d.ts +36 -0
- package/dist/host/uninstall-opencode.js +141 -0
- package/dist/mcp/tools.js +7 -1
- package/dist/renderer/inspect-renderer.js +23 -6
- package/dist/renderer/rule-renderer.js +4 -2
- package/dist/store/evidence-store.js +37 -2
- package/dist/store/profile-score.d.ts +55 -0
- package/dist/store/profile-score.js +100 -0
- package/dist/store/profile-store.d.ts +22 -5
- package/dist/store/profile-store.js +42 -6
- package/dist/store/rule-origin.d.ts +39 -0
- package/dist/store/rule-origin.js +84 -0
- package/dist/store/types.d.ts +24 -0
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/scripts/postinstall.js +76 -42
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* T3 — 사용자 반복 우회 (user_bypass).
|
|
3
3
|
*
|
|
4
|
-
* 트리거 조건 (ADR-002):
|
|
5
|
-
* 7d 내
|
|
4
|
+
* 트리거 조건 (ADR-002, R6-P1 로 suppress→flag 약화):
|
|
5
|
+
* 7d 내 bypass_7d ≥ 5 → flag (사용자 주의 환기)
|
|
6
6
|
*
|
|
7
|
-
*
|
|
7
|
+
* 입력 (ADR-017 D1, 2026-10-06): bypass_7d 는 violations.jsonl 의 kind:'bypass_confirmed'
|
|
8
|
+
* (FORGEN_USER_CONFIRMED=1 명시 우회) 만 센다. 과거 bypass.jsonl 자연어 휴리스틱(전량 오탐)은 폐기.
|
|
9
|
+
* 의미: "사용자가 같은 룰을 7일에 5번 명시적으로 우회했다 → 룰이 틀렸을 가능성, 검토 요청".
|
|
8
10
|
*/
|
|
9
11
|
import type { Rule } from '../../store/types.js';
|
|
10
12
|
import type { LifecycleEvent, RuleSignals } from './types.js';
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* T3 — 사용자 반복 우회 (user_bypass).
|
|
3
3
|
*
|
|
4
|
-
* 트리거 조건 (ADR-002):
|
|
5
|
-
* 7d 내
|
|
4
|
+
* 트리거 조건 (ADR-002, R6-P1 로 suppress→flag 약화):
|
|
5
|
+
* 7d 내 bypass_7d ≥ 5 → flag (사용자 주의 환기)
|
|
6
6
|
*
|
|
7
|
-
*
|
|
7
|
+
* 입력 (ADR-017 D1, 2026-10-06): bypass_7d 는 violations.jsonl 의 kind:'bypass_confirmed'
|
|
8
|
+
* (FORGEN_USER_CONFIRMED=1 명시 우회) 만 센다. 과거 bypass.jsonl 자연어 휴리스틱(전량 오탐)은 폐기.
|
|
9
|
+
* 의미: "사용자가 같은 룰을 7일에 5번 명시적으로 우회했다 → 룰이 틀렸을 가능성, 검토 요청".
|
|
8
10
|
*/
|
|
9
11
|
export function detect(input) {
|
|
10
12
|
const threshold = input.threshold_count ?? 5;
|
|
@@ -27,7 +29,7 @@ export function detect(input) {
|
|
|
27
29
|
kind: 't3_user_bypass',
|
|
28
30
|
rule_id: rule.rule_id,
|
|
29
31
|
evidence: {
|
|
30
|
-
source: '
|
|
32
|
+
source: 'violations:bypass_confirmed',
|
|
31
33
|
refs: [],
|
|
32
34
|
metrics: { bypass_7d: s.bypass_7d },
|
|
33
35
|
},
|
|
@@ -40,8 +40,36 @@ export interface ViolationEntry {
|
|
|
40
40
|
rule_id: string;
|
|
41
41
|
session_id: string;
|
|
42
42
|
source: 'stop-guard' | 'subagent-stop-guard' | 'pre-tool-guard' | 'post-tool-guard' | 'evidence-store' | 'manual';
|
|
43
|
-
|
|
43
|
+
/**
|
|
44
|
+
* block/deny = 실제 차단. correction = 메타가드 advise(기록만). bypass_confirmed = 사용자가
|
|
45
|
+
* FORGEN_USER_CONFIRMED=1 로 명시 우회(ADR-017 D1 — T3 의 유일한 입력).
|
|
46
|
+
*/
|
|
47
|
+
kind: 'block' | 'deny' | 'correction' | 'bypass_confirmed';
|
|
44
48
|
message_preview?: string;
|
|
49
|
+
/** 영수증 식별자. `forgen block <id> --ok|--fp` 와 verdicts.jsonl 조인 키. */
|
|
50
|
+
violation_id?: string;
|
|
51
|
+
/** 어느 패턴/프래그먼트가 매칭됐는가 (최대 160자). */
|
|
52
|
+
matched?: string;
|
|
53
|
+
target_kind?: 'command' | 'response' | 'file';
|
|
54
|
+
/** 전문 sha256 앞 16자 — 전문은 receipts/<id>.txt 에 24h TTL 로만 보관. */
|
|
55
|
+
target_hash?: string;
|
|
56
|
+
}
|
|
57
|
+
export type Verdict = 'correct' | 'false_positive' | 'unsure';
|
|
58
|
+
export interface VerdictEntry {
|
|
59
|
+
at: string;
|
|
60
|
+
violation_id: string;
|
|
61
|
+
rule_id: string;
|
|
62
|
+
verdict: Verdict;
|
|
63
|
+
/** 사람 > 모델. user 판정은 auto 를 덮어쓴다. */
|
|
64
|
+
by: 'auto' | 'user';
|
|
65
|
+
reason?: string;
|
|
66
|
+
}
|
|
67
|
+
/** D2: Stop 에서 실제 평가된 룰의 결과 (통과/위반). violations.jsonl 과 분리 — T2·explain 오염 방지. */
|
|
68
|
+
export interface CheckEntry {
|
|
69
|
+
at: string;
|
|
70
|
+
session_id: string;
|
|
71
|
+
rule_id: string;
|
|
72
|
+
result: 'pass' | 'violation';
|
|
45
73
|
}
|
|
46
74
|
export interface BypassEntry {
|
|
47
75
|
at: string;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI handler for `forgen rule merge-mined [--apply]` (ADR-017 D3).
|
|
3
|
+
*
|
|
4
|
+
* 채굴(behavior_inference, `auto:`) 룰을 채굴끼리만 병합하고, explicit 룰과 같은 개념인
|
|
5
|
+
* 채굴 룰은 explicit 에 *링크*만 건다(흡수 금지 — ADR-013 불변식). 기본은 dry-run:
|
|
6
|
+
* "채굴 N → M (병합 K, explicit 링크 L)" 과 각 클러스터의 멤버·대표 policy 를 출력한다.
|
|
7
|
+
* `--apply` 로 적용. 되돌리기는 `forgen rule unmerge <id>`.
|
|
8
|
+
*/
|
|
9
|
+
import { type MinedMergePlan } from './correction-cluster-runner.js';
|
|
10
|
+
export declare function renderMinedMergePlan(plan: MinedMergePlan): string;
|
|
11
|
+
export declare function handleMergeMined(args: string[]): Promise<void>;
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI handler for `forgen rule merge-mined [--apply]` (ADR-017 D3).
|
|
3
|
+
*
|
|
4
|
+
* 채굴(behavior_inference, `auto:`) 룰을 채굴끼리만 병합하고, explicit 룰과 같은 개념인
|
|
5
|
+
* 채굴 룰은 explicit 에 *링크*만 건다(흡수 금지 — ADR-013 불변식). 기본은 dry-run:
|
|
6
|
+
* "채굴 N → M (병합 K, explicit 링크 L)" 과 각 클러스터의 멤버·대표 policy 를 출력한다.
|
|
7
|
+
* `--apply` 로 적용. 되돌리기는 `forgen rule unmerge <id>`.
|
|
8
|
+
*/
|
|
9
|
+
import { runMinedRuleMerge } from './correction-cluster-runner.js';
|
|
10
|
+
const POLICY_PREVIEW = 70;
|
|
11
|
+
function preview(policy) {
|
|
12
|
+
const one = policy.replace(/\s+/g, ' ').trim();
|
|
13
|
+
return one.length > POLICY_PREVIEW ? `${one.slice(0, POLICY_PREVIEW)}…` : one;
|
|
14
|
+
}
|
|
15
|
+
function short(id) {
|
|
16
|
+
return id.slice(0, 8);
|
|
17
|
+
}
|
|
18
|
+
export function renderMinedMergePlan(plan) {
|
|
19
|
+
const mergedCount = plan.clusters.reduce((n, c) => n + c.memberIds.length, 0);
|
|
20
|
+
const lines = [];
|
|
21
|
+
lines.push(`채굴 ${plan.totalMined} → ${plan.projectedMined} (병합 ${mergedCount}, explicit 링크 ${plan.explicitLinks.length})`);
|
|
22
|
+
if (plan.explicitLinks.length > 0) {
|
|
23
|
+
lines.push('');
|
|
24
|
+
lines.push(`[explicit 링크 ${plan.explicitLinks.length}] — 채굴 룰은 숨김, explicit 은 "채굴 관측 N회" 만 증가`);
|
|
25
|
+
for (const l of plan.explicitLinks) {
|
|
26
|
+
lines.push(` ${short(l.minedRuleId)} (유사도 ${l.similarity.toFixed(2)}, 관측 ${l.observations}) → ${short(l.explicitRuleId)}`);
|
|
27
|
+
lines.push(` 채굴: ${preview(l.minedPolicy)}`);
|
|
28
|
+
lines.push(` explicit: ${preview(l.explicitPolicy)}`);
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
plan.clusters.forEach((c, i) => {
|
|
32
|
+
lines.push('');
|
|
33
|
+
const absorb = c.absorberId ? ` (기존 통합 룰 ${short(c.absorberId)} 에 흡수)` : '';
|
|
34
|
+
lines.push(`[클러스터 ${i + 1}] ${c.category} · 멤버 ${c.memberIds.length} · created_at ${c.oldestCreatedAt.slice(0, 10)} 기준${absorb}`);
|
|
35
|
+
lines.push(` 대표: ${preview(c.representativePolicy)}`);
|
|
36
|
+
c.memberIds.forEach((id, j) => {
|
|
37
|
+
lines.push(` - ${short(id)} ${preview(c.memberPolicies[j] ?? '')}`);
|
|
38
|
+
});
|
|
39
|
+
});
|
|
40
|
+
if (plan.explicitLinks.length === 0 && plan.clusters.length === 0) {
|
|
41
|
+
lines.push('');
|
|
42
|
+
lines.push('병합/링크 대상 없음.');
|
|
43
|
+
}
|
|
44
|
+
return lines.join('\n');
|
|
45
|
+
}
|
|
46
|
+
export async function handleMergeMined(args) {
|
|
47
|
+
const apply = args.includes('--apply');
|
|
48
|
+
const unknown = args.filter((a) => a !== '--apply');
|
|
49
|
+
if (unknown.length > 0) {
|
|
50
|
+
console.error(`Usage: forgen rule merge-mined [--apply] (unknown: ${unknown.join(' ')})`);
|
|
51
|
+
process.exit(2);
|
|
52
|
+
}
|
|
53
|
+
const { plan, applied } = await runMinedRuleMerge({ apply });
|
|
54
|
+
console.log(renderMinedMergePlan(plan));
|
|
55
|
+
if (!applied) {
|
|
56
|
+
if (plan.explicitLinks.length > 0 || plan.clusters.length > 0) {
|
|
57
|
+
console.log('');
|
|
58
|
+
console.log('(dry-run) 적용하려면: forgen rule merge-mined --apply');
|
|
59
|
+
}
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
console.log('');
|
|
63
|
+
console.log(`✓ 적용 — explicit 링크 ${applied.linked}, 신규 통합 룰 ${applied.mergedRuleIds.length}, superseded 원본 ${applied.supersededIds.length}`);
|
|
64
|
+
for (const id of applied.mergedRuleIds)
|
|
65
|
+
console.log(` 통합 룰: ${id}`);
|
|
66
|
+
console.log(' 되돌리기: forgen rule unmerge <통합 룰 id | explicit 룰 id>');
|
|
67
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Rule relevance — "이번 턴에 어떤 룰이 관련 있는가" (ADR-017 D2, 턴 단위 룰 관련도)
|
|
3
|
+
*
|
|
4
|
+
* UserPromptSubmit 에서 프롬프트를 활성 룰의 `trigger`/`policy` 용어와 매칭해
|
|
5
|
+
* `state/turn-rules-<session>.json` 에 기록한다. statusline 이 이 파일을 읽어 "관련 룰 N" 을 보여주고
|
|
6
|
+
* `forgen status --turn` 이 각 룰의 원 교정(날짜·종류·사용자 발화)을 함께 보여준다.
|
|
7
|
+
*
|
|
8
|
+
* 정직성 원칙:
|
|
9
|
+
* - "관련" 이지 "적용" 이 아니다. 모델이 룰을 따랐는지는 여기서 알 수 없다(ADR-017 §5 — 인용 태그는 보류).
|
|
10
|
+
* - 프롬프트 원문은 저장하지 않는다. sha256 앞 16자만 남긴다(어느 프롬프트의 결과인지 대조용).
|
|
11
|
+
* - 프롬프트 주입에는 아무것도 보태지 않는다 — 토큰 비용 0.
|
|
12
|
+
*
|
|
13
|
+
* 매칭 (solution-matcher 와 같은 term 매칭 재사용):
|
|
14
|
+
* - 룰 용어: `extractTags`(solution-format) 를 trigger + policy 의 8단어 창마다 돌려 합친다. extractTags 는
|
|
15
|
+
* 빈도순 8개 cap 이 있어 긴 policy 를 통째로 넣으면 핵심 명사가 잘린다 — 8단어 창이면 cap 이 안 걸린다.
|
|
16
|
+
* - 프롬프트 매칭: `classifyMatch`(term-matcher) 를 **전체 룰 용어 합집합에 대해 한 번** 호출한다 —
|
|
17
|
+
* 프롬프트 NFC 정규화·한글 stem Set 계산이 룰 수와 무관하게 1회. 영문은 단어 경계, 한글은 조사 제거 후 비교.
|
|
18
|
+
* - 공통어 제외: term-matcher NEGATIVE_TERM_BLOCKLIST(코드/파일/테스트 …) + scoring-algorithms COMMON_TAGS
|
|
19
|
+
* (수정/추가/함수 …) + 룰 문장에 흔한 메타어(RULE_COMMON_TERMS: 사용자/작업/먼저/금지 …).
|
|
20
|
+
*
|
|
21
|
+
* 임계 (보수적 — 거짓 양성이 신뢰를 깎는다):
|
|
22
|
+
* 용어마다 가중치: 식별자급 1.0, 일반 0.5. 합 ≥ 1.0 이면 관련.
|
|
23
|
+
* 즉 **일반 용어 2개 이상, 또는 식별자급 용어 1개**.
|
|
24
|
+
* 식별자급 = 영문/숫자 6자 이상(`statusline`, `codex-cli`) 또는 한글 3음절 이상(`한국어`, `에이전트`, `리서치`).
|
|
25
|
+
* 한글은 음절당 정보량이 라틴 문자의 약 2배라 3음절을 영문 6자에 대응시켰다 — 2음절어(설계·검증·병렬)는
|
|
26
|
+
* 단독으로는 잡지 않는다. ("한국어로 답해" 가 '사용자 응답 언어' 룰을 잡아야 한다는 ADR-017 §검증 기준.)
|
|
27
|
+
*
|
|
28
|
+
* 비용: 룰 100개 × 프롬프트 1개 5ms 이내(테스트로 고정). 프롬프트는 앞 32KB 만 본다.
|
|
29
|
+
*/
|
|
30
|
+
import type { Rule } from '../store/types.js';
|
|
31
|
+
export interface RuleRelevance {
|
|
32
|
+
rule_id: string;
|
|
33
|
+
/** 매칭 용어 가중치 합(식별자급 1.0 · 일반 0.5). 임계 RELEVANCE_THRESHOLD 이상만 반환. */
|
|
34
|
+
score: number;
|
|
35
|
+
matchedTerms: string[];
|
|
36
|
+
}
|
|
37
|
+
export interface TurnRulesFile {
|
|
38
|
+
at: string;
|
|
39
|
+
session_id: string;
|
|
40
|
+
/** sha256(prompt) 앞 16자 — 원문 저장 금지. */
|
|
41
|
+
prompt_hash: string;
|
|
42
|
+
rules: RuleRelevance[];
|
|
43
|
+
}
|
|
44
|
+
export declare const RELEVANCE_THRESHOLD = 1;
|
|
45
|
+
export declare const PROMPT_HASH_LENGTH = 16;
|
|
46
|
+
/**
|
|
47
|
+
* 룰 문장에 흔히 등장하지만 "이 턴과 관련" 의 근거가 못 되는 메타어.
|
|
48
|
+
* NEGATIVE_TERM_BLOCKLIST(코드/파일/테스트/에러) · COMMON_TAGS(수정/추가/함수) 와 합쳐 제외한다.
|
|
49
|
+
*/
|
|
50
|
+
export declare const RULE_COMMON_TERMS: Set<string>;
|
|
51
|
+
/** 영문/숫자 6자 이상 또는 한글 3음절 이상 — 단독으로도 관련 근거가 되는 용어. */
|
|
52
|
+
export declare function isSpecificTerm(term: string): boolean;
|
|
53
|
+
/**
|
|
54
|
+
* 룰 한 개의 매칭 용어. trigger + policy 를 8단어 창으로 extractTags 해 합친다(손실 없음).
|
|
55
|
+
* 반환은 중복 제거·필터(길이/블록리스트/공통어) 완료 상태.
|
|
56
|
+
*/
|
|
57
|
+
export declare function ruleTerms(rule: Pick<Rule, 'trigger' | 'policy'>): string[];
|
|
58
|
+
/**
|
|
59
|
+
* 프롬프트와 관련된 룰. 순수 함수 — IO 없음. 임계 이상만, score 내림차순(동점은 rule_id 순).
|
|
60
|
+
*/
|
|
61
|
+
export declare function relevantRules(prompt: string, rules: readonly Rule[]): RuleRelevance[];
|
|
62
|
+
export declare function promptHash(prompt: string): string;
|
|
63
|
+
export declare function turnRulesPath(sessionId: string): string;
|
|
64
|
+
/** 덮어쓰기(세션당 최신 턴 하나). 디렉터리 0700 · 파일 0600 — 다른 세션 캐시와 같은 정책. */
|
|
65
|
+
export declare function writeTurnRules(sessionId: string, prompt: string, rules: RuleRelevance[]): TurnRulesFile;
|
|
66
|
+
/** 부재·손상이면 null (fail-open). */
|
|
67
|
+
export declare function readTurnRules(sessionId: string): TurnRulesFile | null;
|
|
68
|
+
/**
|
|
69
|
+
* `forgen status --turn` 의 세션 결정: 지정 세션의 파일이 있으면 그것, 없으면 가장 최근 turn-rules 파일.
|
|
70
|
+
* 반환은 원래 session_id 가 아니라 파일명에서 복원한 sanitized id — 읽기에는 충분하다.
|
|
71
|
+
*/
|
|
72
|
+
export declare function resolveTurnRulesSession(preferred?: string): string | null;
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Rule relevance — "이번 턴에 어떤 룰이 관련 있는가" (ADR-017 D2, 턴 단위 룰 관련도)
|
|
3
|
+
*
|
|
4
|
+
* UserPromptSubmit 에서 프롬프트를 활성 룰의 `trigger`/`policy` 용어와 매칭해
|
|
5
|
+
* `state/turn-rules-<session>.json` 에 기록한다. statusline 이 이 파일을 읽어 "관련 룰 N" 을 보여주고
|
|
6
|
+
* `forgen status --turn` 이 각 룰의 원 교정(날짜·종류·사용자 발화)을 함께 보여준다.
|
|
7
|
+
*
|
|
8
|
+
* 정직성 원칙:
|
|
9
|
+
* - "관련" 이지 "적용" 이 아니다. 모델이 룰을 따랐는지는 여기서 알 수 없다(ADR-017 §5 — 인용 태그는 보류).
|
|
10
|
+
* - 프롬프트 원문은 저장하지 않는다. sha256 앞 16자만 남긴다(어느 프롬프트의 결과인지 대조용).
|
|
11
|
+
* - 프롬프트 주입에는 아무것도 보태지 않는다 — 토큰 비용 0.
|
|
12
|
+
*
|
|
13
|
+
* 매칭 (solution-matcher 와 같은 term 매칭 재사용):
|
|
14
|
+
* - 룰 용어: `extractTags`(solution-format) 를 trigger + policy 의 8단어 창마다 돌려 합친다. extractTags 는
|
|
15
|
+
* 빈도순 8개 cap 이 있어 긴 policy 를 통째로 넣으면 핵심 명사가 잘린다 — 8단어 창이면 cap 이 안 걸린다.
|
|
16
|
+
* - 프롬프트 매칭: `classifyMatch`(term-matcher) 를 **전체 룰 용어 합집합에 대해 한 번** 호출한다 —
|
|
17
|
+
* 프롬프트 NFC 정규화·한글 stem Set 계산이 룰 수와 무관하게 1회. 영문은 단어 경계, 한글은 조사 제거 후 비교.
|
|
18
|
+
* - 공통어 제외: term-matcher NEGATIVE_TERM_BLOCKLIST(코드/파일/테스트 …) + scoring-algorithms COMMON_TAGS
|
|
19
|
+
* (수정/추가/함수 …) + 룰 문장에 흔한 메타어(RULE_COMMON_TERMS: 사용자/작업/먼저/금지 …).
|
|
20
|
+
*
|
|
21
|
+
* 임계 (보수적 — 거짓 양성이 신뢰를 깎는다):
|
|
22
|
+
* 용어마다 가중치: 식별자급 1.0, 일반 0.5. 합 ≥ 1.0 이면 관련.
|
|
23
|
+
* 즉 **일반 용어 2개 이상, 또는 식별자급 용어 1개**.
|
|
24
|
+
* 식별자급 = 영문/숫자 6자 이상(`statusline`, `codex-cli`) 또는 한글 3음절 이상(`한국어`, `에이전트`, `리서치`).
|
|
25
|
+
* 한글은 음절당 정보량이 라틴 문자의 약 2배라 3음절을 영문 6자에 대응시켰다 — 2음절어(설계·검증·병렬)는
|
|
26
|
+
* 단독으로는 잡지 않는다. ("한국어로 답해" 가 '사용자 응답 언어' 룰을 잡아야 한다는 ADR-017 §검증 기준.)
|
|
27
|
+
*
|
|
28
|
+
* 비용: 룰 100개 × 프롬프트 1개 5ms 이내(테스트로 고정). 프롬프트는 앞 32KB 만 본다.
|
|
29
|
+
*/
|
|
30
|
+
import * as crypto from 'node:crypto';
|
|
31
|
+
import * as fs from 'node:fs';
|
|
32
|
+
import * as path from 'node:path';
|
|
33
|
+
import { STATE_DIR } from '../core/paths.js';
|
|
34
|
+
import { atomicWriteJSON, safeReadJSON } from '../hooks/shared/atomic-write.js';
|
|
35
|
+
import { sanitizeId } from '../hooks/shared/sanitize-id.js';
|
|
36
|
+
import { COMMON_TAGS } from './scoring-algorithms.js';
|
|
37
|
+
import { extractTags } from './solution-format.js';
|
|
38
|
+
import { classifyMatch, filterMatchableTerms } from './term-matcher.js';
|
|
39
|
+
export const RELEVANCE_THRESHOLD = 1.0;
|
|
40
|
+
const SPECIFIC_WEIGHT = 1.0;
|
|
41
|
+
const GENERIC_WEIGHT = 0.5;
|
|
42
|
+
const SPECIFIC_LATIN_MIN = 6;
|
|
43
|
+
const SPECIFIC_HANGUL_MIN = 3;
|
|
44
|
+
/** 프롬프트 매칭 상한 — 붙여넣기 대용량 프롬프트가 훅 지연을 만들지 않게. */
|
|
45
|
+
const PROMPT_MAX_CHARS = 32_000;
|
|
46
|
+
export const PROMPT_HASH_LENGTH = 16;
|
|
47
|
+
/**
|
|
48
|
+
* 룰 문장에 흔히 등장하지만 "이 턴과 관련" 의 근거가 못 되는 메타어.
|
|
49
|
+
* NEGATIVE_TERM_BLOCKLIST(코드/파일/테스트/에러) · COMMON_TAGS(수정/추가/함수) 와 합쳐 제외한다.
|
|
50
|
+
*/
|
|
51
|
+
export const RULE_COMMON_TERMS = new Set([
|
|
52
|
+
// 한국어 — 룰 policy 의 상투어
|
|
53
|
+
'사용자', '오너', '작업', '기능', '요청', '방식', '방법', '단계', '진행', '시작', '완료', '상황', '전체', '필요',
|
|
54
|
+
'이전', '앞으로', '반드시', '명시', '지시', '먼저', '금지', '가능', '결과', '내용', '정리', '확인', '처리',
|
|
55
|
+
'규칙', '정책', '기준', '순서', '상태', '경우', '대상', '포함', '제외', '실제', '실행', '유지', '우선',
|
|
56
|
+
'새로운', '기존', '현재', '이후', '이렇게', '그렇게', '하지', '말것', '않는다', '한다', '해야', '해라', '하라',
|
|
57
|
+
// 영어 — 프로젝트/도구 이름 등 어느 프롬프트에나 나오는 것
|
|
58
|
+
'forgen', 'claude', 'user', 'users', 'rule', 'rules', 'work', 'task', 'tasks', 'session', 'sessions',
|
|
59
|
+
'project', 'make', 'need', 'needs', 'always', 'never', 'must', 'please', 'help', 'want',
|
|
60
|
+
]);
|
|
61
|
+
/** 영문/숫자 6자 이상 또는 한글 3음절 이상 — 단독으로도 관련 근거가 되는 용어. */
|
|
62
|
+
export function isSpecificTerm(term) {
|
|
63
|
+
if (/[가-힣]/.test(term))
|
|
64
|
+
return term.length >= SPECIFIC_HANGUL_MIN;
|
|
65
|
+
return term.length >= SPECIFIC_LATIN_MIN;
|
|
66
|
+
}
|
|
67
|
+
function isCommonTerm(term) {
|
|
68
|
+
const t = term.toLowerCase();
|
|
69
|
+
return RULE_COMMON_TERMS.has(t) || COMMON_TAGS.has(t);
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* extractTags 는 호출당 최대 8개(빈도순)만 돌려준다. 단어 8개짜리 창으로 잘라 호출하면 창마다 후보가 8개
|
|
73
|
+
* 이하라 cap 이 절대 걸리지 않는다 — 실 룰 45개 중 43개가 문장 단위 호출에서는 용어를 잃었다(실측).
|
|
74
|
+
*/
|
|
75
|
+
const TERM_WINDOW_WORDS = 8;
|
|
76
|
+
/**
|
|
77
|
+
* 룰 한 개의 매칭 용어. trigger + policy 를 8단어 창으로 extractTags 해 합친다(손실 없음).
|
|
78
|
+
* 반환은 중복 제거·필터(길이/블록리스트/공통어) 완료 상태.
|
|
79
|
+
*/
|
|
80
|
+
export function ruleTerms(rule) {
|
|
81
|
+
const words = `${rule.trigger ?? ''} ${rule.policy ?? ''}`.split(/\s+/).filter(Boolean);
|
|
82
|
+
const seen = new Set();
|
|
83
|
+
for (let i = 0; i < words.length; i += TERM_WINDOW_WORDS) {
|
|
84
|
+
for (const tag of extractTags(words.slice(i, i + TERM_WINDOW_WORDS).join(' ')))
|
|
85
|
+
seen.add(tag);
|
|
86
|
+
}
|
|
87
|
+
return filterMatchableTerms([...seen]).filter((t) => !isCommonTerm(t));
|
|
88
|
+
}
|
|
89
|
+
function scoreTerms(terms) {
|
|
90
|
+
let s = 0;
|
|
91
|
+
for (const t of terms)
|
|
92
|
+
s += isSpecificTerm(t) ? SPECIFIC_WEIGHT : GENERIC_WEIGHT;
|
|
93
|
+
return Math.round(s * 100) / 100;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* 프롬프트와 관련된 룰. 순수 함수 — IO 없음. 임계 이상만, score 내림차순(동점은 rule_id 순).
|
|
97
|
+
*/
|
|
98
|
+
export function relevantRules(prompt, rules) {
|
|
99
|
+
if (!prompt || rules.length === 0)
|
|
100
|
+
return [];
|
|
101
|
+
const text = prompt.length > PROMPT_MAX_CHARS ? prompt.slice(0, PROMPT_MAX_CHARS) : prompt;
|
|
102
|
+
const termsByRule = [];
|
|
103
|
+
const union = new Set();
|
|
104
|
+
for (const rule of rules) {
|
|
105
|
+
const terms = ruleTerms(rule);
|
|
106
|
+
if (terms.length === 0)
|
|
107
|
+
continue;
|
|
108
|
+
termsByRule.push({ rule_id: rule.rule_id, terms });
|
|
109
|
+
for (const t of terms)
|
|
110
|
+
union.add(t);
|
|
111
|
+
}
|
|
112
|
+
if (union.size === 0)
|
|
113
|
+
return [];
|
|
114
|
+
// 프롬프트 정규화·한글 stem 은 이 한 번의 호출 안에서만 계산된다.
|
|
115
|
+
const matched = new Set(classifyMatch(text, [], [...union]).matchedTags);
|
|
116
|
+
if (matched.size === 0)
|
|
117
|
+
return [];
|
|
118
|
+
const out = [];
|
|
119
|
+
for (const { rule_id, terms } of termsByRule) {
|
|
120
|
+
const hits = terms.filter((t) => matched.has(t));
|
|
121
|
+
if (hits.length === 0)
|
|
122
|
+
continue;
|
|
123
|
+
const score = scoreTerms(hits);
|
|
124
|
+
if (score < RELEVANCE_THRESHOLD)
|
|
125
|
+
continue;
|
|
126
|
+
out.push({ rule_id, score, matchedTerms: hits });
|
|
127
|
+
}
|
|
128
|
+
return out.sort((a, b) => b.score - a.score || a.rule_id.localeCompare(b.rule_id));
|
|
129
|
+
}
|
|
130
|
+
// ── turn-rules 파일 IO (훅이 쓰고 statusline / status --turn 이 읽는다) ──
|
|
131
|
+
export function promptHash(prompt) {
|
|
132
|
+
return crypto.createHash('sha256').update(prompt).digest('hex').slice(0, PROMPT_HASH_LENGTH);
|
|
133
|
+
}
|
|
134
|
+
export function turnRulesPath(sessionId) {
|
|
135
|
+
return path.join(STATE_DIR, `turn-rules-${sanitizeId(sessionId)}.json`);
|
|
136
|
+
}
|
|
137
|
+
/** 덮어쓰기(세션당 최신 턴 하나). 디렉터리 0700 · 파일 0600 — 다른 세션 캐시와 같은 정책. */
|
|
138
|
+
export function writeTurnRules(sessionId, prompt, rules) {
|
|
139
|
+
const data = {
|
|
140
|
+
at: new Date().toISOString(),
|
|
141
|
+
session_id: sessionId,
|
|
142
|
+
prompt_hash: promptHash(prompt),
|
|
143
|
+
rules,
|
|
144
|
+
};
|
|
145
|
+
atomicWriteJSON(turnRulesPath(sessionId), data, { mode: 0o600, dirMode: 0o700 });
|
|
146
|
+
return data;
|
|
147
|
+
}
|
|
148
|
+
/** 부재·손상이면 null (fail-open). */
|
|
149
|
+
export function readTurnRules(sessionId) {
|
|
150
|
+
const data = safeReadJSON(turnRulesPath(sessionId), null);
|
|
151
|
+
if (!data || typeof data !== 'object' || !Array.isArray(data.rules))
|
|
152
|
+
return null;
|
|
153
|
+
const rules = data.rules.filter((r) => !!r && typeof r === 'object' && typeof r.rule_id === 'string' && typeof r.score === 'number').map((r) => ({ rule_id: r.rule_id, score: r.score, matchedTerms: Array.isArray(r.matchedTerms) ? r.matchedTerms.filter((t) => typeof t === 'string') : [] }));
|
|
154
|
+
return {
|
|
155
|
+
at: typeof data.at === 'string' ? data.at : '',
|
|
156
|
+
session_id: typeof data.session_id === 'string' ? data.session_id : sessionId,
|
|
157
|
+
prompt_hash: typeof data.prompt_hash === 'string' ? data.prompt_hash : '',
|
|
158
|
+
rules,
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* `forgen status --turn` 의 세션 결정: 지정 세션의 파일이 있으면 그것, 없으면 가장 최근 turn-rules 파일.
|
|
163
|
+
* 반환은 원래 session_id 가 아니라 파일명에서 복원한 sanitized id — 읽기에는 충분하다.
|
|
164
|
+
*/
|
|
165
|
+
export function resolveTurnRulesSession(preferred) {
|
|
166
|
+
try {
|
|
167
|
+
if (preferred && fs.existsSync(turnRulesPath(preferred)))
|
|
168
|
+
return preferred;
|
|
169
|
+
let best = null;
|
|
170
|
+
for (const name of fs.readdirSync(STATE_DIR)) {
|
|
171
|
+
const m = /^turn-rules-(.+)\.json$/.exec(name);
|
|
172
|
+
if (!m)
|
|
173
|
+
continue;
|
|
174
|
+
const mtime = fs.statSync(path.join(STATE_DIR, name)).mtimeMs;
|
|
175
|
+
if (!best || mtime > best.mtime)
|
|
176
|
+
best = { id: m[1], mtime };
|
|
177
|
+
}
|
|
178
|
+
return best?.id ?? null;
|
|
179
|
+
}
|
|
180
|
+
catch {
|
|
181
|
+
return null;
|
|
182
|
+
}
|
|
183
|
+
}
|
|
@@ -10,4 +10,9 @@
|
|
|
10
10
|
* - hard strength rule 은 cli 로도 suppress 불가 (ADR-002 불변 원칙).
|
|
11
11
|
*/
|
|
12
12
|
export declare function handleSuppressRule(args: string[]): Promise<void>;
|
|
13
|
+
/**
|
|
14
|
+
* ADR-017 D1: enforce_mode 전환. `advise` = 차단 대신 기록만(precision 자동 강등과 같은 상태),
|
|
15
|
+
* `enforce` = 차단 복귀(자동 강등 해제 — 사용자 명시). 하드 룰은 advise 로 내릴 수 없다.
|
|
16
|
+
*/
|
|
17
|
+
export declare function handleEnforceMode(args: string[], mode: 'block' | 'advise'): Promise<void>;
|
|
13
18
|
export declare function handleActivateRule(args: string[]): Promise<void>;
|
|
@@ -45,6 +45,36 @@ export async function handleSuppressRule(args) {
|
|
|
45
45
|
console.log(` Policy: ${rule.policy.slice(0, 80)}`);
|
|
46
46
|
console.log(` Re-activate with: forgen activate-rule ${rule.rule_id}`);
|
|
47
47
|
}
|
|
48
|
+
/**
|
|
49
|
+
* ADR-017 D1: enforce_mode 전환. `advise` = 차단 대신 기록만(precision 자동 강등과 같은 상태),
|
|
50
|
+
* `enforce` = 차단 복귀(자동 강등 해제 — 사용자 명시). 하드 룰은 advise 로 내릴 수 없다.
|
|
51
|
+
*/
|
|
52
|
+
export async function handleEnforceMode(args, mode) {
|
|
53
|
+
const { loadAllRules, saveRule } = await import('../store/rule-store.js');
|
|
54
|
+
const prefix = args[0];
|
|
55
|
+
if (!prefix) {
|
|
56
|
+
console.log(`usage: forgen rule ${mode === 'advise' ? 'advise' : 'enforce'} <id-or-prefix>`);
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
const matches = loadAllRules().filter((r) => r.rule_id.startsWith(prefix) && r.status === 'active');
|
|
60
|
+
if (matches.length === 0) {
|
|
61
|
+
console.log(`no active rule matching ${prefix}`);
|
|
62
|
+
return;
|
|
63
|
+
}
|
|
64
|
+
if (matches.length > 1) {
|
|
65
|
+
console.log(`ambiguous prefix ${prefix} → ${matches.map((r) => r.rule_id.slice(0, 8)).join(', ')}`);
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
const rule = matches[0];
|
|
69
|
+
if (mode === 'advise' && rule.strength === 'hard') {
|
|
70
|
+
console.log(`✗ [forgen] hard rule ${rule.rule_id.slice(0, 8)} cannot be set to advise`);
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
const prev = rule.enforce_mode ?? 'block';
|
|
74
|
+
rule.enforce_mode = mode;
|
|
75
|
+
saveRule(rule);
|
|
76
|
+
console.log(`✓ [forgen] ${rule.rule_id.slice(0, 8)} enforce_mode: ${prev} → ${mode}${mode === 'block' ? ' (차단 복귀 — 자동 강등 해제)' : ' (기록만, 차단 안 함)'}`);
|
|
77
|
+
}
|
|
48
78
|
export async function handleActivateRule(args) {
|
|
49
79
|
const partial = args[0];
|
|
50
80
|
if (!partial) {
|
package/dist/fgx.js
CHANGED
|
@@ -16,7 +16,7 @@ const args = process.argv.slice(2);
|
|
|
16
16
|
const FORGEN_SUBCOMMANDS = new Set([
|
|
17
17
|
// Wave 1 통합(feature-audit 2026-07-21): status(←stats/health/dashboard/me/
|
|
18
18
|
// recall/explain/last-block/watch), dev(←probe-workflow/parity/migrate/regress-map).
|
|
19
|
-
'forge', 'compound', 'skill', 'status', 'learn', 'statusline',
|
|
19
|
+
'forge', 'compound', 'skill', 'block', 'status', 'learn', 'statusline', 'rules',
|
|
20
20
|
'config', 'mcp', 'init', 'install', 'maintenance', 'dev',
|
|
21
21
|
'notepad', 'inspect', 'doctor', 'uninstall', 'rule',
|
|
22
22
|
'classify-enforce', 'rule-meta-scan', 'lifecycle-scan',
|
|
@@ -29,6 +29,8 @@ export function processCorrection(req) {
|
|
|
29
29
|
axis_hint: req.axis_hint,
|
|
30
30
|
// avoid-this는 현재 설정과 반대 방향의 교정 → mismatch 감지용
|
|
31
31
|
direction: req.kind === 'avoid-this' ? 'opposite' : 'same',
|
|
32
|
+
// ADR-017 D0: 사용자 발화 원문(있을 때만). rule-origin 이 "당신의 말" 인용에 사용.
|
|
33
|
+
...(req.user_quote ? { user_quote: req.user_quote } : {}),
|
|
32
34
|
},
|
|
33
35
|
});
|
|
34
36
|
appendEvidence(evidence); // T1 lifecycle trigger fires here for explicit_correction
|
|
@@ -281,10 +281,9 @@ async function main() {
|
|
|
281
281
|
})() || toolResponse;
|
|
282
282
|
if (target) {
|
|
283
283
|
try {
|
|
284
|
-
const [{ loadActiveRules }, { recordViolation,
|
|
284
|
+
const [{ loadActiveRules }, { recordViolation, matchedFragment }, { compileSafeRegex, safeRegexTest }, { preprocessForMatch },] = await Promise.all([
|
|
285
285
|
import('../store/rule-store.js'),
|
|
286
286
|
import('../engine/lifecycle/signals.js'),
|
|
287
|
-
import('../engine/lifecycle/bypass-detector.js'),
|
|
288
287
|
import('./shared/safe-regex.js'),
|
|
289
288
|
import('./shared/command-parser.js'),
|
|
290
289
|
]);
|
|
@@ -317,21 +316,17 @@ async function main() {
|
|
|
317
316
|
source: 'post-tool-guard',
|
|
318
317
|
kind: 'block',
|
|
319
318
|
message_preview: target.slice(0, 120),
|
|
320
|
-
|
|
319
|
+
matched: matchedFragment(re.regex, mechTarget),
|
|
320
|
+
target_kind: toolName === 'Bash' ? 'command' : 'file',
|
|
321
|
+
}, { receipt_text: target });
|
|
321
322
|
messages.push(`<compound-rule-violation>\n[Forgen] Rule ${rule.rule_id.slice(0, 8)} pattern matched in ${toolName} output.\n${spec.block_message ?? rule.policy.slice(0, 120)}\n</compound-rule-violation>`);
|
|
322
323
|
}
|
|
323
324
|
}
|
|
324
|
-
//
|
|
325
|
-
//
|
|
326
|
-
//
|
|
327
|
-
//
|
|
328
|
-
//
|
|
329
|
-
const isFileContentTool = toolName === 'Write' || toolName === 'Edit';
|
|
330
|
-
const bypassTarget = isFileContentTool ? preprocessForMatch(target, 'masked') : target;
|
|
331
|
-
const candidates = scanForBypass({ rules, tool_name: toolName, tool_output: bypassTarget, session_id: sessionId });
|
|
332
|
-
for (const c of candidates) {
|
|
333
|
-
recordBypass({ rule_id: c.rule_id, session_id: c.session_id, tool: c.tool, pattern_preview: c.pattern_preview });
|
|
334
|
-
}
|
|
325
|
+
// ADR-017 D1 (2026-10-06): 자연어 휴리스틱 bypass 기록(scanForBypass → bypass.jsonl)을
|
|
326
|
+
// 중단. 실측 1,114건 전부 룰 policy 의 단어("먼저","Team","Fable")가 도구 출력에
|
|
327
|
+
// 등장한 오탐이었고 실 사용자 우회는 0건. T3 는 이제 FORGEN_USER_CONFIRMED 감사
|
|
328
|
+
// 기록(kind:'bypass_confirmed')만 입력으로 쓴다. bypass-detector 모듈과 기존
|
|
329
|
+
// bypass.jsonl 은 삭제하지 않는다(역사 보존) — 읽지 않을 뿐.
|
|
335
330
|
}
|
|
336
331
|
catch (e) {
|
|
337
332
|
log.debug('enforce_via/bypass post-tool dispatch 실패', e);
|