@tienne/gestalt 0.83.1 → 0.84.0

package/dist/src/harness-review/collect.js

@@ -0,0 +1,253 @@
+/**
+ * 참조 후보 수집 오케스트레이터.
+ *
+ * review 스킬 1단계 뒤에 한 번 돌아 검출기 여섯 개의 결과를 JSON 하나로 묶는다. 판정은 하지 않는다.
+ * 검출기 하나가 예외를 던져도 그 검출기만 skipped로 적고 나머지는 끝까지 돈다. 후보 수집이
+ * 리뷰를 막으면 안 되기 때문이다(C0). 조회가 막혔거나 원격이 없으면 참조 검사 영역을 리뷰 불가로
+ * 표시해 스킬이 사용자에게 물을 수 있게 한다(C7).
+ */
+import { execFileSync } from 'node:child_process';
+import { basename, resolve } from 'node:path';
+import { runGh } from '../review-loop/fetch.js';
+import { backwardSearch, } from './backward-search.js';
+import { findCopyDrift } from './copy-drift.js';
+import { forwardSearch } from './forward-search.js';
+import { GithubCodeSearchAdapter, orgWildcard } from './github-code-search.js';
+import { extractIdentifiersFromGit, isHarnessPath, isRuleDocPath } from './identifiers.js';
+import { detectRelatedRepos, readOriginRepo } from './related-repos.js';
+import { findRuleIdListGapsFromGit } from './rule-id-lists.js';
+import { LocalCloneBackend } from './search-backend.js';
+import { findSelfContamination } from './self-contamination.js';
+import { findSelfReferences } from './self-references.js';
+import { REFERENCE_CANDIDATE_KINDS, } from './types.js';
+export const COLLECT_BACKENDS = ['local', 'github'];
+export const DETECTOR_NAMES = [
+    'relatedRepos',
+    'identifiers',
+    'selfContamination',
+    'copyDrift',
+    'ruleIdListGap',
+    'forwardSearch',
+    'backwardSearch',
+    'selfReferences',
+];
+function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+function git(repoRoot, args) {
+    return execFileSync('git', ['-c', 'core.quotepath=false', ...args], {
+        cwd: repoRoot,
+        encoding: 'utf-8',
+        maxBuffer: 64 * 1024 * 1024,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+}
+const REPO_SLUG_RE = /^[^/\s=]+\/[^/\s=]+$/;
+/** `--repo-dir` 값을 레포 표기와 디렉토리로 푼다. 표기를 안 주면 clone의 origin에서 읽는다 */
+export function parseRepoDirs(raw, org) {
+    const out = [];
+    const seen = new Set();
+    for (const entry of raw) {
+        const eq = entry.indexOf('=');
+        const left = eq > 0 ? entry.slice(0, eq) : '';
+        let repo;
+        let dir;
+        if (REPO_SLUG_RE.test(left)) {
+            repo = left;
+            dir = resolve(entry.slice(eq + 1));
+        }
+        else {
+            dir = resolve(entry);
+            const origin = readOriginRepo(dir);
+            repo = origin
+                ? `${origin.owner}/${origin.name}`
+                : org
+                    ? `${org}/${basename(dir)}`
+                    : basename(dir);
+        }
+        if (seen.has(repo))
+            continue;
+        seen.add(repo);
+        out.push({ repo, dir });
+    }
+    return out;
+}
+function emptyCandidates() {
+    return Object.fromEntries(REFERENCE_CANDIDATE_KINDS.map((k) => [k, []]));
+}
+/**
+ * base와 head 사이 변경에서 diff 밖 검사 후보를 모은다. 리뷰를 막지 않으려고 어떤 경우에도
+ * 예외를 던지지 않고 결과를 돌려준다. 워킹트리는 head가 체크아웃된 상태라고 본다.
+ */
+export async function collectReferenceCandidates(opts) {
+    const repoRoot = resolve(opts.repoRoot);
+    const gh = opts.gh ?? runGh;
+    const limitations = [];
+    const detectors = {};
+    const candidates = emptyCandidates();
+    const lookupBlocked = [];
+    const skippedRepos = [];
+    const skip = (name, reason) => {
+        detectors[name] = { status: 'skipped', reason };
+        limitations.push(`${name} 검출기를 건너뛰었다: ${reason}`);
+    };
+    const run = (name, body) => {
+        try {
+            const value = body();
+            detectors[name] = { status: 'ok' };
+            return value;
+        }
+        catch (e) {
+            skip(name, errorMessage(e));
+            return undefined;
+        }
+    };
+    const addCandidates = (list) => {
+        for (const c of list)
+            candidates[c.kind].push(c);
+    };
+    const noteBlocked = (source, blocked) => {
+        if (!blocked || blocked.reason === 'noGitHubRemote')
+            return;
+        lookupBlocked.push({ source, reason: blocked.reason, detail: blocked.detail });
+    };
+    // ── 관련 레포 ──────────────────────────────────────
+    const detection = run('relatedRepos', () => detectRelatedRepos(repoRoot, {
+        extraRepos: opts.extraRepos ?? [],
+        gh: (args) => gh(args),
+        now: opts.now,
+        refresh: opts.refresh,
+    }));
+    const noGitHubRemote = detection?.noGitHubRemote === true;
+    const found = detection && !detection.noGitHubRemote ? detection : undefined;
+    if (detection?.noGitHubRemote)
+        limitations.push(detection.reason);
+    const org = found?.org ?? null;
+    const repo = found ? `${found.self.owner}/${found.self.name}` : basename(repoRoot);
+    const relatedRepos = found?.relatedRepos.map((r) => `${r.owner}/${r.name}`) ?? [];
+    const repoDirs = parseRepoDirs(opts.repoDirs ?? [], org).filter((d) => d.repo !== repo);
+    try {
+        const headSha = git(repoRoot, ['rev-parse', opts.head]).trim();
+        const worktreeHead = git(repoRoot, ['rev-parse', 'HEAD']).trim();
+        if (worktreeHead !== headSha) {
+            limitations.push('워킹트리가 head 커밋이 아니다. 자기오염과 순방향 검사는 워킹트리 파일을 읽으므로 결과가 head와 어긋날 수 있다');
+        }
+    }
+    catch {
+        // ref를 못 읽으면 아래 검출기들이 같은 원인으로 각자 skipped를 남긴다
+    }
+    // ── 레포 안 검출기 ────────────────────────────────
+    const identifiers = run('identifiers', () => extractIdentifiersFromGit(repoRoot, opts.base, opts.head)) ?? [];
+    run('selfContamination', () => {
+        const diff = git(repoRoot, ['diff', '--no-color', opts.base, opts.head]);
+        addCandidates(findSelfContamination({ repoRoot, diff, repoName: repo }));
+    });
+    run('copyDrift', () => {
+        const drift = findCopyDrift({
+            repoRoot,
+            base: opts.base,
+            head: opts.head,
+            repo,
+            codeGraphDbPath: opts.codeGraphDbPath,
+        });
+        addCandidates(drift.candidates);
+        limitations.push(...drift.limitations);
+    });
+    run('ruleIdListGap', () => {
+        addCandidates(findRuleIdListGapsFromGit(repoRoot, opts.base, opts.head, repo));
+    });
+    // 역방향 검색은 관련 레포만 본다. 같은 레포 안에 남은 옛 이름은 여기서 찾는다
+    run('selfReferences', () => {
+        addCandidates(findSelfReferences({ repoRoot, base: opts.base, head: opts.head, repo, identifiers }));
+    });
+    // ── 순방향 ────────────────────────────────────────
+    run('forwardSearch', () => {
+        const changed = git(repoRoot, ['diff', '--name-only', '--diff-filter=d', opts.base, opts.head])
+            .split('\n')
+            .filter((p) => p !== '' && (isHarnessPath(p) || isRuleDocPath(p)));
+        const forward = forwardSearch({
+            ownRepo: { repo, dir: repoRoot },
+            otherRepos: repoDirs,
+            files: changed,
+            gh,
+        });
+        addCandidates(forward.candidates);
+        limitations.push(...forward.limitations);
+        noteBlocked('forwardSearch', forward.blocked);
+    });
+    if (repoDirs.length === 0) {
+        limitations.push('다른 레포 경로와 자리표시자는 --repo-dir로 받은 로컬 clone에서만 확인한다. 받은 clone이 없어 자기 레포만 봤다');
+    }
+    // ── 역방향 ────────────────────────────────────────
+    const backendUsed = opts.backend === 'github' ? 'githubSearch' : 'localClone';
+    let searchedRepos = [];
+    let backward;
+    let adapter;
+    if (detectors.identifiers.status === 'skipped') {
+        skip('backwardSearch', '식별자를 뽑지 못했다');
+    }
+    else if (opts.backend === 'github' && org === null) {
+        skip('backwardSearch', 'GitHub 원격이 없어 검색할 조직을 모른다');
+    }
+    else {
+        let backend;
+        if (opts.backend === 'github' && org !== null) {
+            adapter = new GithubCodeSearchAdapter({ owner: org, selfRepo: repo, gh });
+            backend = adapter;
+            searchedRepos = [...relatedRepos, orgWildcard(org)];
+            limitations.push(...adapter.limitations);
+        }
+        else {
+            backend = new LocalCloneBackend(repoDirs);
+            searchedRepos = [...new Set([...relatedRepos, ...repoDirs.map((d) => d.repo)])];
+            if (searchedRepos.length === 0) {
+                limitations.push('로컬 백엔드는 조직 전체를 못 찾는다. 관련 레포도 --repo-dir도 없어 역방향 검색 대상이 비었다');
+            }
+        }
+        searchedRepos = searchedRepos.filter((r) => r !== repo);
+        try {
+            backward = await backwardSearch({
+                identifiers,
+                repos: searchedRepos,
+                backend,
+                selfRepo: repo,
+            });
+            detectors.backwardSearch = { status: 'ok' };
+        }
+        catch (e) {
+            skip('backwardSearch', errorMessage(e));
+        }
+        noteBlocked('backwardSearch', adapter?.blocked);
+    }
+    if (backward) {
+        addCandidates(backward.backwardRefs);
+        addCandidates(backward.knowledgeDocs);
+        skippedRepos.push(...backward.skipped);
+        for (const s of backward.skippedIdentifiers) {
+            limitations.push(`식별자 ${s.identifier.value}: ${s.reason}`);
+        }
+    }
+    const crossRepoSkipped = ['relatedRepos', 'forwardSearch', 'backwardSearch'].some((name) => detectors[name]?.status === 'skipped');
+    const counts = Object.fromEntries(REFERENCE_CANDIDATE_KINDS.map((k) => [k, candidates[k].length]));
+    return {
+        version: 1,
+        base: opts.base,
+        head: opts.head,
+        repo,
+        org,
+        backendUsed,
+        relatedRepos,
+        searchedRepos,
+        identifiers,
+        candidates,
+        counts,
+        needsLlmJudgment: backward?.needsLlmJudgment ?? [],
+        lookupBlocked,
+        noGitHubRemote,
+        referenceCheckSkipped: noGitHubRemote || lookupBlocked.length > 0 || skippedRepos.length > 0 || crossRepoSkipped,
+        skippedRepos,
+        detectors,
+        limitations,
+    };
+}
+//# sourceMappingURL=collect.js.map

package/dist/src/harness-review/collect.js.map

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

package/dist/src/harness-review/copy-drift.d.ts

@@ -0,0 +1,83 @@
+import { type GitRunner } from '../code-graph/cochange.js';
+import type { CoChangeTuning } from '../code-graph/types.js';
+import type { ReferenceCandidate } from './types.js';
+export declare const COPY_DRIFT_SOURCES: readonly ["identicalBlob", "coChange", "hiddenCopy", "syncDeclared"];
+export type CopyDriftSource = (typeof COPY_DRIFT_SOURCES)[number];
+export interface CopyDriftOptions {
+    repoRoot: string;
+    base: string;
+    head: string;
+    /** 후보의 targetRepo에 싣는 자기 레포 표기(owner/name). 기본값 '.' */
+    repo?: string;
+    /** 기본값 `<repoRoot>/.gestalt/code-graph.db`. 파일이 없으면 co-change 경로만 건너뛴다 */
+    codeGraphDbPath?: string;
+    coChange?: CoChangeTuning;
+    /** 숨은 사본과 같게 유지 선언 후보에 붙일 앞뒤 줄 수 */
+    contextLines?: number;
+    runGit?: GitRunner;
+}
+export interface CopyDriftResult {
+    /** 네 경로 후보를 합친 목록. 같은 파일 쌍은 한 경로에만 남는다 */
+    candidates: ReferenceCandidate[];
+    bySource: Record<CopyDriftSource, ReferenceCandidate[]>;
+    coChange: {
+        checked: boolean;
+        reason?: string;
+    };
+    /** 건너뛰거나 실패한 경로. 후보가 비었다고 "어긋남 없음"으로 읽지 않게 따로 싣는다 */
+    limitations: string[];
+}
+export declare const DEFAULT_CONTEXT_LINES = 2;
+export declare const MAX_DIFF_CONTEXT_LINES = 6;
+export declare const MAX_HIDDEN_COPY_PHRASES = 40;
+export declare const MAX_HITS_PER_PHRASE = 20;
+/** 이보다 짧은 구절은 흔한 말이라 다른 문서에 우연히 겹친다 */
+export declare const MIN_PHRASE_CHARS = 10;
+export declare const MIN_ASCII_PHRASE_WORDS = 4;
+/**
+ * 문서에서 두 파일을 같게 유지하라고 적은 자리를 찾는 표현. "동일하게"는
+ * "규칙은 동일하게 지킨다"처럼 사본과 무관한 문장에도 흔하게 나오므로
+ * 이 표현만으로는 후보를 내지 않고 같은 줄에 파일 경로가 둘 있어야 낸다.
+ */
+export declare const SYNC_DECLARATION_PATTERNS: readonly ["같게 유지", "동일하게 유지", "똑같이 유지", "동일하게", "내용 동일", "내용이 같", "keep in sync", "kept in sync", "in sync with", "keep identical", "stay identical"];
+interface SummaryLine {
+    line: number;
+    text: string;
+}
+export interface FileDiffSummary {
+    /** head 쪽 첫 hunk 시작 줄. 파일이 지워졌으면 base 쪽 줄 */
+    firstLine: number;
+    /** base 기준 줄 번호 */
+    removed: SummaryLine[];
+    /** head 기준 줄 번호 */
+    added: SummaryLine[];
+}
+/** 파일별로 지워진 줄과 추가된 줄만 추린다. 지워진 파일은 base 경로를 키로 쓴다 */
+export declare function summarizeDiff(raw: string): Map<string, FileDiffSummary>;
+/** 목록 끼움으로 볼 최소 항목 수. 둘짜리 나열은 산문에서도 흔해 같은 목록이라고 보기 어렵다 */
+export declare const MIN_LIST_ANCHOR_ITEMS = 3;
+export interface ListInsertion {
+    /** 끼운 자리 바로 앞의 원래 목록. diff 밖에서 이 글을 찾는다 */
+    anchor: string;
+    /** 새로 끼운 항목 (구분자 뺀 것) */
+    item: string;
+    sourceLine: number;
+}
+/**
+ * 지운 줄과 추가 줄 짝에서 목록 끝에 항목을 더한 수정을 찾는다.
+ * 줄 전체에서 뽑은 구절은 새 줄에도 그대로 남아 숨은 사본 검색에 안 걸린다. 끼운 자리 앞의 목록만 떼어 찾는다
+ */
+export declare function findListInsertions(diff: FileDiffSummary): ListInsertion[];
+/**
+ * 삭제되거나 바뀐 규칙 줄에서 다른 문서에 그대로 남았을 법한 구절 하나를 뽑는다.
+ * 서식 기호에서 끊는 이유는 사본마다 백틱이나 굵게 표시가 달라서 서식을 낀 구절로는
+ * 고정 문자열 검색이 안 맞기 때문이다.
+ */
+export declare function extractKeyPhrase(line: string): string | null;
+/**
+ * base와 head 사이에서 사본 한쪽만 바뀐 자리를 후보로 모은다. 네 경로를 따로 돌리고
+ * 한 경로가 실패해도 나머지 결과는 살린다. 판정은 하지 않는다 — 후보만 낸다.
+ */
+export declare function findCopyDrift(opts: CopyDriftOptions): CopyDriftResult;
+export {};
+//# sourceMappingURL=copy-drift.d.ts.map

package/dist/src/harness-review/copy-drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-drift.d.ts","sourceRoot":"","sources":["../../../src/harness-review/copy-drift.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,kBAAkB,sEAKrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACxD,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,qDAAqD;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,uJAY5B,CAAC;AAiCX,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,mBAAmB;IACnB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAoBvE;AAED,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAQvC,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AA+BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,EAAE,CAmBzE;AAmDD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa5D;AAkBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CA4PrE"}