@tienne/gestalt 0.83.1 → 0.84.0

package/dist/src/harness-review/rule-id-lists.js

@@ -0,0 +1,189 @@
+/**
+ * 코드 속 룰 ID 목록에서 빠진 ID를 찾는다.
+ *
+ * 룰북에서 룰을 새로 정의하거나 정의 줄을 고치면, 그 룰을 골라 담는 코드 목록(금지 목록 펼칠
+ * 룰, 자가점검 항목 같은 것)도 함께 봐야 할 때가 있다. 이런 누락은 남아 있는 문자열이 아니라
+ * 빠진 문자열이라 금지어 grep으로는 원리상 안 잡힌다. 그래서 같은 룰북의 ID를 여럿 나열한
+ * 목록을 찾고 바뀐 ID가 그 목록에 없으면 후보로 낸다.
+ *
+ * 목록은 대개 룰 일부만 일부러 고른 것이라 빠진 게 곧 결함은 아니다. 후보는 전부
+ * needsLlmJudgment로 넘기고 harness-reviewer가 목록 위 설명을 읽고 판정한다.
+ */
+import { execFileSync } from 'node:child_process';
+import { ruleIdOfDefinitionLine, parseUnifiedDiff } from './identifiers.js';
+/** 이보다 적게 나열한 자리는 목록이 아니라 설명 속 언급으로 본다 */
+export const MIN_LIST_IDS = 3;
+/** 룰 ID 사이가 이 줄 수보다 벌어지면 다른 목록으로 나눈다 */
+export const MAX_LIST_GAP_LINES = 2;
+export const MAX_LIST_CONTEXT_LINES = 8;
+const CODE_EXT_RE = /\.(?:[cm]?[jt]sx?|json|ya?ml|py)$/;
+// 테스트와 fixture는 룰 일부만 골라 검사하는 게 정상이라 빠진 ID가 결함이 아니다
+const TEST_PATH_RE = /(?:^|\/)(?:tests?|__tests__|fixtures?)\/|\.(?:test|spec)\.[^/]+$/;
+const QUOTED_RULE_ID_RE = /(['"`])([A-Z]{1,2}-\d{1,3})\1/g;
+function isMarkdown(path) {
+    return /\.mdx?$/i.test(path);
+}
+/** diff의 추가 줄에서 정의된 룰 ID를 룰북 경로별로 모은다 */
+export function changedRuleIds(diff) {
+    const out = new Map();
+    for (const f of parseUnifiedDiff(diff)) {
+        const path = f.newPath;
+        if (!path || !isMarkdown(path))
+            continue;
+        for (const h of f.hunks) {
+            for (const l of h.lines) {
+                if (l.type !== 'added')
+                    continue;
+                const id = ruleIdOfDefinitionLine(l.text);
+                if (!id)
+                    continue;
+                if (!out.has(path))
+                    out.set(path, new Set());
+                out.get(path).add(id);
+            }
+        }
+    }
+    return out;
+}
+function definedRuleIds(markdown) {
+    const ids = new Set();
+    let inFence = false;
+    for (const line of markdown.split('\n')) {
+        if (/^\s*(```|~~~)/.test(line)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const id = ruleIdOfDefinitionLine(line);
+        if (id)
+            ids.add(id);
+    }
+    return ids;
+}
+/** 따옴표로 감싼 룰 ID가 줄 간격 MAX_LIST_GAP_LINES 안에서 이어지는 구간을 목록 하나로 묶는다 */
+export function findRuleIdLists(file, content) {
+    const lists = [];
+    let current = null;
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const ids = [...lines[i].matchAll(QUOTED_RULE_ID_RE)].map((m) => m[2]);
+        if (ids.length === 0)
+            continue;
+        const lineNo = i + 1;
+        if (!current || lineNo - current.endLine > MAX_LIST_GAP_LINES) {
+            current = { file, startLine: lineNo, endLine: lineNo, ids: new Set(), entries: [] };
+            lists.push(current);
+        }
+        current.endLine = lineNo;
+        for (const id of ids) {
+            current.ids.add(id);
+            current.entries.push({ id, line: lineNo });
+        }
+    }
+    return lists.filter((l) => l.ids.size >= MIN_LIST_IDS);
+}
+function compareRuleIds(a, b) {
+    const [pa, na] = a.split('-');
+    const [pb, nb] = b.split('-');
+    return pa === pb ? Number(na) - Number(nb) : pa < pb ? -1 : 1;
+}
+/**
+ * 빠진 ID가 들어갈 줄. ID 순으로 정렬된 목록이면 순서상 자리를, 아니면 목록 끝 다음 줄을 준다.
+ * 리뷰어가 코멘트를 달 자리이고 목록 첫 줄을 주면 긴 목록에서 어디를 보라는 건지 흐려진다.
+ */
+export function insertionLine(list, id) {
+    const { entries } = list;
+    const sorted = entries.every((e, i) => i === 0 || compareRuleIds(entries[i - 1].id, e.id) <= 0);
+    if (!sorted)
+        return list.endLine + 1;
+    const before = entries.filter((e) => compareRuleIds(e.id, id) < 0);
+    return before.length === 0 ? list.startLine : before[before.length - 1].line + 1;
+}
+function contextOf(content, list) {
+    const lines = content.split('\n').slice(list.startLine - 1, list.endLine);
+    if (lines.length <= MAX_LIST_CONTEXT_LINES)
+        return lines;
+    return [...lines.slice(0, MAX_LIST_CONTEXT_LINES - 1), `… (${list.endLine}줄까지)`];
+}
+export function findRuleIdListGaps(input) {
+    const changed = changedRuleIds(input.diff);
+    if (changed.size === 0)
+        return [];
+    const rulebooks = [...changed.entries()].flatMap(([path, ids]) => {
+        const content = input.readFile(path);
+        return content === undefined ? [] : [{ path, ids, defined: definedRuleIds(content) }];
+    });
+    const candidates = [];
+    for (const file of input.files) {
+        if (!CODE_EXT_RE.test(file) || TEST_PATH_RE.test(file))
+            continue;
+        const content = input.readFile(file);
+        if (content === undefined)
+            continue;
+        const quotedHere = new Set([...content.matchAll(QUOTED_RULE_ID_RE)].map((m) => m[2]));
+        for (const list of findRuleIdLists(file, content)) {
+            for (const book of rulebooks) {
+                // 다른 룰북의 ID 목록은 같은 접두 글자를 써도 이 룰과 무관하다
+                const shared = [...list.ids].filter((id) => book.defined.has(id)).length;
+                if (shared < MIN_LIST_IDS)
+                    continue;
+                for (const id of book.ids) {
+                    // 한 파일에서 여러 줄로 흩어진 목록(탐지기 등록부 같은 것)은 이미 그 ID를 다른 구간에 들고 있다
+                    if (quotedHere.has(id))
+                        continue;
+                    candidates.push({
+                        kind: 'ruleIdListGap',
+                        sourceFile: file,
+                        sourceLine: insertionLine(list, id),
+                        targetRepo: input.repoName ?? '.',
+                        targetPath: book.path,
+                        matchedText: id,
+                        contextLines: contextOf(content, list),
+                        needsLlmJudgment: true,
+                    });
+                }
+            }
+        }
+    }
+    return candidates;
+}
+/** base와 head 사이 diff로 검사한다. 파일은 head 트리에서 읽는다 */
+export function findRuleIdListGapsFromGit(repoRoot, base, head, repoName) {
+    const git = (...args) => execFileSync('git', ['-c', 'core.quotepath=false', ...args], {
+        cwd: repoRoot,
+        encoding: 'utf-8',
+        maxBuffer: 64 * 1024 * 1024,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    const diff = git('diff', '--no-color', base, head);
+    if (changedRuleIds(diff).size === 0)
+        return [];
+    // 파일마다 git show를 부르면 느려서 따옴표 친 룰 ID가 있는 파일만 먼저 추린다
+    let grepped = '';
+    try {
+        grepped = git('grep', '-l', '-E', `['"\`][A-Z]{1,2}-[0-9]{1,3}['"\`]`, head);
+    }
+    catch {
+        // 걸린 파일이 없으면 git grep이 1로 끝난다
+    }
+    const prefix = `${head}:`;
+    const files = grepped
+        .split('\n')
+        .filter(Boolean)
+        .map((l) => (l.startsWith(prefix) ? l.slice(prefix.length) : l));
+    return findRuleIdListGaps({
+        diff,
+        files,
+        readFile: (p) => {
+            try {
+                return git('show', `${head}:${p}`);
+            }
+            catch {
+                return undefined;
+            }
+        },
+        repoName,
+    });
+}
+//# sourceMappingURL=rule-id-lists.js.map

package/dist/src/harness-review/rule-id-lists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-id-lists.js","sourceRoot":"","sources":["../../../src/harness-review/rule-id-lists.ts"],"names":[],"mappings":"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"}

package/dist/src/harness-review/search-backend.d.ts

@@ -0,0 +1,59 @@
+import type { SearchBackend } from './types.js';
+export interface SearchHit {
+    /** owner/name 표기 */
+    repo: string;
+    /** 레포 루트 기준, 항상 슬래시 구분자 */
+    path: string;
+    /** 1부터 시작 */
+    line: number;
+    /** 매치된 줄 전체. MAX_HIT_TEXT_LENGTH에서 자른다 */
+    text: string;
+}
+export interface SkippedRepo {
+    repo: string;
+    reason: string;
+}
+export interface SearchResult {
+    hits: SearchHit[];
+    /** 검색하지 못한 레포. 결과가 비었다고 "참조 없음"으로 읽지 않게 따로 싣는다 */
+    skipped: SkippedRepo[];
+}
+export interface SearchOptions {
+    /** 레포당 상한. 넘으면 앞쪽만 남긴다 */
+    maxHitsPerRepo?: number;
+}
+/** 식별자 문자열을 관련 레포에서 찾는 역방향 검색. 구현체를 바꿔 끼워도 호출부는 그대로다 */
+export interface CodeSearchBackend extends SearchBackend {
+    /** identifier는 정규식이 아닌 고정 문자열로 찾는다. repos는 owner/name 목록 */
+    search(identifier: string, repos: string[], opts?: SearchOptions): Promise<SearchResult>;
+    /**
+     * 그 레포에 이 경로의 파일이 있는지. `/`가 없으면 같은 이름의 파일이 어디든 있는지 본다.
+     * 모르면 undefined다. 파일 목록을 싸게 못 얻는 백엔드는 구현하지 않는다
+     */
+    hasFile?(repo: string, path: string): boolean | undefined;
+}
+export declare const DEFAULT_MAX_HITS_PER_REPO = 100;
+export declare const MAX_HIT_TEXT_LENGTH = 300;
+export interface LocalRepoSource {
+    /** owner/name */
+    repo: string;
+    /** clone이나 워크트리 디렉토리 */
+    dir: string;
+    /** 지정하면 워킹트리 대신 이 ref(브랜치, SHA)의 트리를 본다 */
+    ref?: string;
+}
+export declare class LocalCloneBackend implements CodeSearchBackend {
+    readonly kind: "localClone";
+    readonly capabilities: {
+        fixedStringSearch: boolean;
+        refSnapshot: boolean;
+        rateLimited: boolean;
+    };
+    private readonly sources;
+    private readonly fileLists;
+    constructor(sources: LocalRepoSource[]);
+    hasFile(repo: string, path: string): boolean | undefined;
+    private fileList;
+    search(identifier: string, repos: string[], opts?: SearchOptions): Promise<SearchResult>;
+}
+//# sourceMappingURL=search-backend.d.ts.map

package/dist/src/harness-review/search-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-backend.d.ts","sourceRoot":"","sources":["../../../src/harness-review/search-backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,4DAA4D;IAC5D,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzF;;;OAGG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC3D;AAED,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAKvC,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IACtC,QAAQ,CAAC,YAAY;;;;MAInB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAE9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwE;gBAEtF,OAAO,EAAE,eAAe,EAAE;IAItC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAYxD,OAAO,CAAC,QAAQ;IAqBV,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,YAAY,CAAC;CAsBzB"}

package/dist/src/harness-review/search-backend.js

@@ -0,0 +1,178 @@
+import { spawnSync } from 'node:child_process';
+import { readFileSync, readdirSync, realpathSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+export const DEFAULT_MAX_HITS_PER_REPO = 100;
+export const MAX_HIT_TEXT_LENGTH = 300;
+const MAX_FILE_BYTES = 1_000_000;
+const SKIPPED_DIRS = new Set(['.git', 'node_modules']);
+export class LocalCloneBackend {
+    kind = 'localClone';
+    capabilities = {
+        fixedStringSearch: true,
+        refSnapshot: true,
+        rateLimited: false,
+    };
+    sources = new Map();
+    fileLists = new Map();
+    constructor(sources) {
+        for (const s of sources)
+            this.sources.set(s.repo, s);
+    }
+    hasFile(repo, path) {
+        const list = this.fileList(repo);
+        if (!list)
+            return undefined;
+        const clean = path.replace(/^\.\//, '').replace(/\/$/, '');
+        if (!clean.includes('/'))
+            return list.names.has(clean);
+        // 모노레포면 같은 경로가 한 단계 안쪽(plugins/*/.claude-plugin/plugin.json)에 있다
+        return (list.paths.has(clean) ||
+            [...list.paths].some((p) => p.startsWith(`${clean}/`) || p.endsWith(`/${clean}`)));
+    }
+    fileList(repo) {
+        if (this.fileLists.has(repo))
+            return this.fileLists.get(repo);
+        const source = this.sources.get(repo);
+        let list = null;
+        if (source && (source.ref || isGitRoot(source.dir))) {
+            const args = source.ref
+                ? ['-C', source.dir, 'ls-tree', '-r', '--name-only', source.ref]
+                : ['-C', source.dir, 'ls-files'];
+            const r = spawnSync('git', ['-c', 'core.quotepath=false', ...args], {
+                encoding: 'utf8',
+                maxBuffer: 256 * 1024 * 1024,
+            });
+            if (r.status === 0) {
+                const paths = new Set(r.stdout.split('\n').filter(Boolean));
+                list = { paths, names: new Set([...paths].map((p) => p.slice(p.lastIndexOf('/') + 1))) };
+            }
+        }
+        this.fileLists.set(repo, list);
+        return list;
+    }
+    async search(identifier, repos, opts = {}) {
+        const max = opts.maxHitsPerRepo ?? DEFAULT_MAX_HITS_PER_REPO;
+        const result = { hits: [], skipped: [] };
+        if (identifier === '')
+            return result;
+        for (const repo of repos) {
+            const source = this.sources.get(repo);
+            if (!source) {
+                result.skipped.push({ repo, reason: '로컬 clone 경로가 없다' });
+                continue;
+            }
+            try {
+                const hits = source.ref
+                    ? grepRef(source, identifier)
+                    : (grepGitWorktree(source, identifier) ?? grepWorktree(source, identifier));
+                result.hits.push(...hits.slice(0, max));
+            }
+            catch (e) {
+                result.skipped.push({ repo, reason: e instanceof Error ? e.message : String(e) });
+            }
+        }
+        return result;
+    }
+}
+function toHit(repo, path, line, text) {
+    return { repo, path, line, text: text.slice(0, MAX_HIT_TEXT_LENGTH) };
+}
+function isSkippedPath(relPath) {
+    return relPath.split('/').some((seg) => SKIPPED_DIRS.has(seg));
+}
+/**
+ * git 작업 트리면 git grep으로 찾는다. 파일을 직접 훑으면 식별자마다 레포 전체를 다시 읽고
+ * node_modules 같은 무시 디렉토리까지 내려갔다가 걸러내서, 큰 레포에서는 식별자 수십 개에 몇 분이 걸린다.
+ * git 레포가 아니면 null을 돌려 직접 훑기로 넘긴다
+ */
+const gitRootCache = new Map();
+// 바깥 레포 안에 든 일반 디렉토리면 git이 바깥 레포를 잡는다. 디렉토리가 곧 작업 트리 루트일 때만 쓴다
+function isGitRoot(dir) {
+    const cached = gitRootCache.get(dir);
+    if (cached !== undefined)
+        return cached;
+    const r = spawnSync('git', ['-C', dir, 'rev-parse', '--show-toplevel'], { encoding: 'utf8' });
+    const ok = r.status === 0 && realpathSync(r.stdout.trim()) === realpathSync(dir);
+    gitRootCache.set(dir, ok);
+    return ok;
+}
+function grepGitWorktree(source, identifier) {
+    if (!isGitRoot(source.dir))
+        return null;
+    const r = spawnSync('git', ['-C', source.dir, 'grep', '-n', '-F', '-I', '--null', '--no-color', '-e', identifier, '--'], { encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 });
+    if (r.error)
+        return null;
+    if (r.status === 1)
+        return [];
+    if (r.status !== 0)
+        return null;
+    return parseGrepLines(source, r.stdout, '');
+}
+function parseGrepLines(source, stdout, prefix) {
+    const hits = [];
+    for (const raw of stdout.split('\n')) {
+        if (!raw.startsWith(prefix))
+            continue;
+        // --null이면 경로와 줄 번호 뒤에 각각 NUL이 붙는다
+        const m = /^([^\0]*)\0(\d+)\0(.*)$/.exec(raw.slice(prefix.length));
+        if (!m)
+            continue;
+        const path = m[1];
+        if (isSkippedPath(path))
+            continue;
+        hits.push(toHit(source.repo, path, Number(m[2]), m[3].trimEnd()));
+    }
+    return hits.sort((a, b) => a.path.localeCompare(b.path) || a.line - b.line);
+}
+function grepWorktree(source, identifier) {
+    const entries = readdirSync(source.dir, { recursive: true, withFileTypes: true });
+    const files = entries
+        .filter((d) => d.isFile())
+        .map((d) => relative(source.dir, join(d.parentPath, d.name)).split(sep).join('/'))
+        .filter((p) => !isSkippedPath(p))
+        .sort();
+    const hits = [];
+    for (const path of files) {
+        let buf;
+        try {
+            buf = readFileSync(join(source.dir, path));
+        }
+        catch {
+            continue;
+        }
+        if (buf.length > MAX_FILE_BYTES || buf.includes(0))
+            continue;
+        const lines = buf.toString('utf8').split('\n');
+        lines.forEach((text, i) => {
+            if (text.includes(identifier))
+                hits.push(toHit(source.repo, path, i + 1, text.trimEnd()));
+        });
+    }
+    return hits;
+}
+function grepRef(source, identifier) {
+    const ref = source.ref;
+    const r = spawnSync('git', [
+        '-C',
+        source.dir,
+        'grep',
+        '-n',
+        '-F',
+        '-I',
+        '--null',
+        '--no-color',
+        '-e',
+        identifier,
+        ref,
+        '--',
+    ], { encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 });
+    if (r.error)
+        throw r.error;
+    // status 1은 매치 없음이다
+    if (r.status === 1)
+        return [];
+    if (r.status !== 0)
+        throw new Error(`git grep 실패 (${ref}): ${r.stderr.trim()}`);
+    return parseGrepLines(source, r.stdout, `${ref}:`);
+}
+//# sourceMappingURL=search-backend.js.map

package/dist/src/harness-review/search-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-backend.js","sourceRoot":"","sources":["../../../src/harness-review/search-backend.ts"],"names":[],"mappings":"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"}

package/dist/src/harness-review/self-contamination.d.ts

@@ -0,0 +1,83 @@
+import type { ReferenceCandidate } from './types.js';
+export type TermKind = 'ko' | 'en';
+/**
+ * literal은 diff에 실제로 적힌 금지어, synonym은 룰북 표에서 넓힌 말이다.
+ * phraseRoot는 자리표시자가 든 금지 예 구절("A가 원조다")에서 조사를 떼고 남긴 어근이다.
+ */
+export type TermOrigin = 'literal' | 'synonym' | 'phraseRoot';
+export interface SearchTerm {
+    text: string;
+    kind: TermKind;
+    origin: TermOrigin;
+    /** 룰의 뜻이 조건부거나 정의뿐이라 문맥을 읽어야 판정되는 검색어 */
+    needsLlmJudgment: boolean;
+}
+export interface AddedRule {
+    file: string;
+    line: number;
+    ruleId?: string;
+    text: string;
+    terms: SearchTerm[];
+    /** 검색어가 하나도 없는 룰. grep으로는 확정할 수 없다 */
+    definitionOnly: boolean;
+}
+export interface SelfContaminationCandidate extends ReferenceCandidate {
+    kind: 'selfContamination';
+    targetLine: number;
+    searchTerm: string;
+    termOrigin: TermOrigin | 'definition';
+}
+export interface SelfContaminationInput {
+    repoRoot: string;
+    diff: string;
+    repoName?: string;
+    /** 후보 줄 앞뒤로 함께 돌려줄 줄 수 */
+    contextLines?: number;
+    /** 동의어를 읽을 룰북 경로(repoRoot 기준). 없으면 이름으로 찾는다 */
+    rulebookPaths?: string[];
+}
+export declare function parseAddedLines(diff: string): Map<string, Map<number, string>>;
+/** 파일별로 diff에서 지워진 줄. 고친 표 행의 옛 모습을 찾는 데만 쓴다 */
+export declare function parseRemovedLines(diff: string): Map<string, string[]>;
+/** 따옴표, 백틱, 괄호 안은 인용이다. verify-rule-refs의 bareProse와 같은 기준 */
+export declare function stripQuoted(line: string): string;
+/**
+ * 자리표시자가 든 금지 예 구절에서 한국어 금지어 어근을 뽑는다.
+ * "A가 원조다"는 통째로는 어디에도 안 나오지만 "원조"는 다른 문서 산문에 그대로 남는다.
+ * 자리표시자 없는 구절은 extractCellTerms가 통째로 쓰므로 여기서는 빈 배열이다.
+ */
+export declare function extractPhraseRoots(cell: string): string[];
+/** 셀 하나에서 금지어 후보를 뽑는다. 따옴표와 백틱, 괄호 안 나열, 화살표 앞 영어 원어 */
+export declare function extractCellTerms(cell: string, plainFallback: boolean): string[];
+interface TableRow {
+    line: number;
+    ruleId?: string;
+    /** 검색어를 뽑는 칸만 이은 글. 정의 줄 판별에 쓴다 */
+    searchText: string;
+    fullText: string;
+    terms: string[];
+    /** 금지 예 구절에서 뽑은 어근. terms와 겹치는 말은 뺀다 */
+    roots: string[];
+}
+export declare function parseRuleTables(markdown: string): TableRow[];
+export declare function extractAddedRules(repoRoot: string, added: Map<string, Map<number, string>>, removed?: Map<string, string[]>): AddedRule[];
+/**
+ * 룰북 표에서 같은 행에 놓인 다른 언어의 말을 동의어로 넓힌다.
+ * 한글 금지어면 영어 원어를, 영어 원어면 그 한글 직역형을 더한다.
+ * 같은 행 안의 형제 금지어는 넣지 않는다. 다른 룰의 말까지 끌려온다.
+ */
+export declare function expandSearchTerms(rules: AddedRule[], rulebookFiles: string[]): SearchTerm[];
+/** 행의 화살표 짝 중 key가 든 짝의 상대편. key가 어느 짝에도 없으면 null */
+export declare function arrowPartners(text: string, key: string): string[] | null;
+/** 띄어쓰기 변형과 영어의 구분자 변형을 잡는 정규식. 한글 어간은 별도 변형으로 만든다 */
+export declare function termPatterns(term: SearchTerm): Array<{
+    regex: RegExp;
+    exact: boolean;
+}>;
+/**
+ * 추가된 금지어와 룰 문장으로 레포 전체 md를 grep해 후보를 낸다.
+ * 뜻으로만 정의된 룰과 조건부 룰, 동의어 일치는 needsLlmJudgment=true로 두고 확정하지 않는다.
+ */
+export declare function findSelfContamination(input: SelfContaminationInput): SelfContaminationCandidate[];
+export {};
+//# sourceMappingURL=self-contamination.d.ts.map

package/dist/src/harness-review/self-contamination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-contamination.d.ts","sourceRoot":"","sources":["../../../src/harness-review/self-contamination.ts"],"names":[],"mappings":"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"}