@tienne/gestalt 0.83.2 → 0.84.1

package/dist/src/harness-review/replay.d.ts

@@ -0,0 +1,163 @@
+import { type CollectBackend } from './collect.js';
+/**
+ * 과거 하네스 PR 재현 스크립트(scripts/local/replay-harness-prs.ts)의 순수 로직.
+ *
+ * 스크립트는 사내 레포를 다루므로 gitignore 자리에 두고 커밋하지 않는다. 테스트가 그 경로를
+ * import하면 CI에서 파일이 없어 깨지니 인자 해석과 리포트 조립만 여기로 뺐다. 이 모듈은
+ * 측정값을 표로 옮길 뿐 합격이나 불합격을 가르지 않는다. 기준 수치는 첫 측정을 본 뒤에 정한다.
+ */
+export declare const DEFAULT_OLD_VERSION = "0.83.2";
+/**
+ * 새 버전 칸의 이름. package.json 버전은 배포 전까지 옛 버전과 같은 번호라 커밋으로 가른다.
+ * 미커밋 변경이 있으면 그 커밋과도 다른 코드가 돈 것이라 따로 적는다.
+ */
+export declare function checkoutLabel(shortSha: string | null, dirty?: boolean): string;
+export interface ReplayArgs {
+    prList: string;
+    repoDir: string;
+    oldVersion: string;
+    repeat: number;
+    backend: CollectBackend;
+    /** collect의 `--repo-dir`로 그대로 넘긴다 (`owner/name=<path>` 또는 `<path>`) */
+    relatedDirs: string[];
+    /** 리뷰 리포트를 만드는 셸 명령. 없으면 collect 후보만 잰다 */
+    reviewCmd: string | null;
+    /** 회차마다 워크트리의 `.gestalt/code-graph.db`로 복사할 DB. 없으면 co-change 경로를 못 돈다 */
+    codeGraphDb: string | null;
+}
+export type ParseResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+export declare const REPLAY_USAGE: string;
+export declare function parseReplayArgs(argv: string[], cwd: string): ParseResult<ReplayArgs>;
+/** fix가 따라온 PR에서 리뷰가 잡았어야 하는 자리 하나 */
+export interface ReplayExpectation {
+    id: string;
+    description: string;
+    /** 코멘트가 달린 파일이나 후보가 가리키는 파일 중 하나와 같아야 한다 */
+    path?: string;
+    line?: number;
+    /** 줄 번호를 몇 줄까지 어긋나도 같은 자리로 볼지. 없으면 정확히 같아야 한다 */
+    lineTolerance?: number;
+    /** 코멘트 본문에 들어 있어야 하는 글자 */
+    text?: string;
+}
+export interface ReplayEntry {
+    id: string;
+    pr: number | null;
+    /** `gh pr view --repo`로 넘긴다. 없으면 레포 디렉토리의 원격을 따른다 */
+    repo: string | null;
+    base: string | null;
+    head: string | null;
+    followedByFix: boolean;
+    expected: ReplayExpectation[];
+    note: string | null;
+}
+/**
+ * PR 목록 파일을 읽는다. 배열이거나 `{ "entries": [...] }`다.
+ *
+ * 항목마다 `pr`(번호) 또는 `base`와 `head`(커밋)가 있어야 한다. `followedByFix`를 안 적으면
+ * `expected`가 있는지로 정한다.
+ */
+export declare function parseReplayList(text: string): ParseResult<ReplayEntry[]>;
+export type ReplayCommentSource = 'collect' | 'review';
+/** 한 회차가 낸 코멘트 하나. collect 후보와 리뷰 리포트 이슈를 같은 모양으로 맞춘다 */
+export interface ReplayComment {
+    source: ReplayCommentSource;
+    kind: string;
+    path: string;
+    line: number | null;
+    /** 후보가 가리키는 다른 자리. 리뷰 코멘트면 null */
+    relatedPath: string | null;
+    /** relatedPath 안의 줄. 후보가 줄을 안 주면 null */
+    relatedLine: number | null;
+    body: string;
+}
+/** `gestalt harness-refs collect --json` 출력에서 후보를 꺼낸다. 모양이 다르면 빈 배열이다 */
+export declare function commentsFromCollect(json: unknown): ReplayComment[];
+/**
+ * 리뷰 명령이 쓴 JSON에서 코멘트를 꺼낸다.
+ *
+ * ReviewIssue 배열, `{ issues }`나 `{ comments }`, ReviewResult 배열 중 무엇이든 받는다.
+ * 이 텍스트는 세어서 표에 옮길 뿐 재현 절차에 영향을 주지 않는다.
+ */
+export declare function commentsFromReview(json: unknown): ReplayComment[];
+/** 회차를 넘어 같은 코멘트로 묶을 때 쓰는 키. 본문 공백 차이는 무시한다 */
+export declare function commentFingerprint(c: ReplayComment): string;
+export declare function matchesExpectation(c: ReplayComment, e: ReplayExpectation): boolean;
+export declare const STEP_STATUSES: readonly ["ok", "unsupported", "failed", "skipped"];
+export type StepStatus = (typeof STEP_STATUSES)[number];
+export interface ReplayStep {
+    status: StepStatus;
+    detail?: string;
+}
+export type ReplayVersion = 'old' | 'new';
+export interface ReplayRun {
+    version: ReplayVersion;
+    iteration: number;
+    collect: ReplayStep & {
+        referenceCheckSkipped?: boolean;
+        lookupBlocked?: number;
+    };
+    review: ReplayStep;
+    comments: ReplayComment[];
+}
+export interface ReplayEntryResult {
+    entry: ReplayEntry;
+    base: string | null;
+    head: string | null;
+    /** base와 head를 못 구했거나 워크트리를 못 만든 경우. 이때 runs는 비어 있다 */
+    error: string | null;
+    runs: ReplayRun[];
+}
+export interface ReplayReportInput {
+    runId: string;
+    createdAt: string;
+    repoLabel: string;
+    backend: CollectBackend;
+    repeat: number;
+    reviewCmdGiven: boolean;
+    versions: Record<ReplayVersion, string>;
+    results: ReplayEntryResult[];
+}
+export interface VersionSummary {
+    counts: number[];
+    mean: number | null;
+    notes: string[];
+}
+export declare function summarizeVersion(runs: ReplayRun[], version: ReplayVersion): VersionSummary;
+export interface ExpectationHits {
+    expectation: ReplayExpectation;
+    hits: Record<ReplayVersion, {
+        runs: number;
+        total: number;
+    }>;
+}
+export declare function expectationHits(result: ReplayEntryResult): ExpectationHits[];
+/** 측정 리포트 본문. 숫자와 회차별 상태만 적고 통과 여부는 적지 않는다 */
+export declare function buildReplayReport(input: ReplayReportInput): string;
+export interface LabelItem {
+    entryId: string;
+    comment: ReplayComment;
+    /** 새 버전 회차 중 이 코멘트가 나온 횟수 */
+    seenRuns: number;
+    totalRuns: number;
+    inOldVersion: boolean;
+}
+/** 새 버전이 낸 코멘트를 회차를 넘어 중복 없이 모은다 */
+export declare function collectLabelItems(results: ReplayEntryResult[]): LabelItem[];
+export declare const LABEL_PREFIX = "label:";
+/** 사용자가 코멘트마다 correct나 incorrect를 적는 시트 */
+export declare function buildLabelSheet(input: ReplayReportInput): string;
+/**
+ * 재현 중 자식 프로세스가 부르는 gh가 읽기만 하는지 본다.
+ *
+ * 리뷰 명령이 review 스킬을 돌리면 PR 대상일 때 코멘트를 게시하려 한다. 재현은 게시 없이
+ * 리포트만 내야 하므로 스크립트가 PATH 앞에 둔 gh 가림막이 이 함수로 쓰기 호출을 끊는다.
+ */
+export declare function isReadOnlyGhCall(args: string[]): boolean;
+//# sourceMappingURL=replay.d.ts.map

package/dist/src/harness-review/replay.d.ts.map

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