@tienne/gestalt 0.83.2 → 0.84.0

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

@@ -0,0 +1,130 @@
+import { execFileSync } from 'node:child_process';
+import { runGh } from '../review-loop/fetch.js';
+import { resolveRemoteUrl } from './remote-url.js';
+export const BLOCK_REASONS = [
+    'notLoggedIn',
+    'noPermission',
+    'rateLimited',
+    'noGitHubRemote',
+];
+export const GH_SEARCH_LIMITATIONS = [
+    '기본 브랜치만 검색한다. 열린 PR이나 다른 브랜치의 변경은 안 보인다',
+    '푸시 직후 인덱싱이 늦을 수 있다. 방금 바뀐 파일은 결과에 없을 수 있다',
+    '아카이브된 레포와 포크는 인덱싱되지 않는다',
+];
+export const GH_SEARCH_MAX_LIMIT = 100;
+/**
+ * gh 실패 출력에서 막힘 종류를 가른다. 판정 못 하면 null이라 부르는 쪽이 일반 오류로 다룬다.
+ * 속도 제한을 권한 없음보다 먼저 본다 — 둘 다 403이라 메시지로만 갈린다.
+ */
+export function classifyGhFailure(text) {
+    const t = text.toLowerCase();
+    if (/rate limit|secondary rate|abuse detection|retry-after/.test(t))
+        return 'rateLimited';
+    if (/gh auth login|not logged in|not logged into|authentication required|no oauth token|http 401|bad credentials/.test(t)) {
+        return 'notLoggedIn';
+    }
+    if (/http 404|not found|http 403|resource not accessible|forbidden|saml|must have push access|requires authentication/.test(t)) {
+        return 'noPermission';
+    }
+    return null;
+}
+function failureText(e) {
+    if (typeof e !== 'object' || e === null)
+        return String(e);
+    const { stderr, stdout, message } = e;
+    return [stderr, stdout, message]
+        .filter((v) => v !== undefined && v !== null)
+        .map(String)
+        .join('\n');
+}
+const defaultGit = (args) => execFileSync('git', [...args], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+/** origin이 github.com을 가리키면 owner를, 아니면 null을 돌려준다 */
+export function resolveGithubOwner(repoRoot, git = defaultGit) {
+    let url;
+    try {
+        url = git(['-C', repoRoot, 'remote', 'get-url', 'origin']).trim();
+    }
+    catch {
+        return null;
+    }
+    const m = /github\.com[:/]([^/\s]+)\/[^/\s]+?(?:\.git)?$/.exec(resolveRemoteUrl(url));
+    return m ? m[1] : null;
+}
+export function createGithubSearchBackend(gh = runGh) {
+    const backend = {
+        kind: 'githubSearch',
+        capabilities: {
+            defaultBranchOnly: true,
+            indexingDelay: true,
+            indexesArchivedAndForks: false,
+            limitations: GH_SEARCH_LIMITATIONS,
+        },
+        rateLimitState: {},
+        search(query, opts) {
+            const limitations = [...GH_SEARCH_LIMITATIONS];
+            if (opts.owner === null) {
+                return {
+                    status: 'blocked',
+                    reason: 'noGitHubRemote',
+                    detail: 'GitHub 원격이 없다',
+                    limitations,
+                };
+            }
+            const limit = Math.min(opts.limit ?? 30, GH_SEARCH_MAX_LIMIT);
+            const args = [
+                'search',
+                'code',
+                query,
+                '--owner',
+                opts.owner,
+                '--json',
+                'path,repository,textMatches',
+                '--limit',
+                String(limit),
+            ];
+            let raw;
+            try {
+                raw = gh(args);
+            }
+            catch (e) {
+                const detail = failureText(e);
+                const reason = classifyGhFailure(detail);
+                if (reason === 'rateLimited')
+                    backend.rateLimitState = { blockedAt: new Date().toISOString() };
+                if (reason === null) {
+                    // 원인을 못 가른 실패도 죽이지 않고 막힘으로 올려 사용자에게 묻는다
+                    return { status: 'blocked', reason: 'noPermission', detail, limitations };
+                }
+                return { status: 'blocked', reason, detail, limitations };
+            }
+            let parsed;
+            try {
+                const json = JSON.parse(raw);
+                if (!Array.isArray(json))
+                    throw new Error('배열이 아니다');
+                parsed = json;
+            }
+            catch (e) {
+                return {
+                    status: 'blocked',
+                    reason: 'noPermission',
+                    detail: `응답 파싱 실패: ${failureText(e)}`,
+                    limitations,
+                };
+            }
+            const hits = parsed.flatMap((h) => h.path && h.repository?.nameWithOwner
+                ? [
+                    {
+                        repo: h.repository.nameWithOwner,
+                        path: h.path,
+                        fragments: (h.textMatches ?? []).flatMap((t) => (t.fragment ? [t.fragment] : [])),
+                    },
+                ]
+                : []);
+            return { status: 'ok', hits, limitations };
+        },
+    };
+    return backend;
+}
+//# sourceMappingURL=github-backend.js.map

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

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

package/dist/src/harness-review/github-code-search.d.ts

@@ -0,0 +1,46 @@
+/**
+ * GitHub 코드 검색을 역방향 검색 인터페이스(CodeSearchBackend)에 맞춘다.
+ *
+ * github-backend.ts는 조직 단위 질의 하나를 돌리고 막힘을 결과 값으로 알린다. 역방향 검색은
+ * 식별자와 레포 목록을 주고 hits와 skipped를 받는 꼴이라 둘을 이어 줄 자리가 필요하다.
+ * 조회가 한 번 막히면 뒤 질의는 gh를 부르지 않고 전부 skipped로 돌려준다. 속도 제한에 걸린 채
+ * 같은 호출을 수십 번 반복하면 제한이 풀리는 시점만 늦어진다.
+ */
+import type { GhRunner } from '../review-loop/fetch.js';
+import { type BlockReason, type GithubSearchBackend } from './github-backend.js';
+import { type CodeSearchBackend, type SearchOptions, type SearchResult } from './search-backend.js';
+export interface GithubLookupBlocked {
+    reason: BlockReason;
+    detail: string;
+}
+export interface GithubCodeSearchOptions {
+    /** 검색할 조직. null이면 GitHub 원격이 없는 레포라 첫 질의에서 바로 막힌다 */
+    owner: string | null;
+    /** 리뷰 중인 레포(owner/name). 조직 전체 검색에 섞여 나와도 버린다 */
+    selfRepo?: string;
+    /** 테스트에서 가짜 gh로 바꾼다. backend를 주면 쓰지 않는다 */
+    gh?: GhRunner;
+    backend?: GithubSearchBackend;
+}
+/** GitHub 결과에는 줄 번호가 없다. 이 값이면 줄을 모른다는 뜻이다 */
+export declare const UNKNOWN_LINE = 0;
+/**
+ * repos에 이 값을 넣으면 목록 밖 레포의 결과도 남긴다. 받기만 하는 레포는 관련 레포 목록이
+ * 비어 있어서 조직 전체를 찾지 않으면 자기를 부르는 레포를 영영 못 찾는다
+ */
+export declare function orgWildcard(owner: string): string;
+export declare class GithubCodeSearchAdapter implements CodeSearchBackend {
+    readonly kind: "githubSearch";
+    readonly capabilities: Record<string, unknown>;
+    /** 첫 막힘. 채워지면 이후 search는 gh를 부르지 않는다 */
+    blocked: GithubLookupBlocked | null;
+    readonly limitations: string[];
+    private readonly backend;
+    private readonly owner;
+    private readonly selfRepo;
+    constructor(opts: GithubCodeSearchOptions);
+    get rateLimitState(): Record<string, unknown> | undefined;
+    search(identifier: string, repos: string[], opts?: SearchOptions): Promise<SearchResult>;
+    private filterHits;
+}
+//# sourceMappingURL=github-code-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-code-search.d.ts","sourceRoot":"","sources":["../../../src/harness-review/github-code-search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,8CAA8C;AAC9C,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAmBD,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,wCAAwC;IACxC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAsD;IAEpF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,IAAI,EAAE,uBAAuB;IAOzC,IAAI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAExD;IAEK,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,YAAY,CAAC;IAsBxB,OAAO,CAAC,UAAU;CA6BnB"}

package/dist/src/harness-review/github-code-search.js

@@ -0,0 +1,94 @@
+import { createGithubSearchBackend, GH_SEARCH_LIMITATIONS, GH_SEARCH_MAX_LIMIT, } from './github-backend.js';
+import { DEFAULT_MAX_HITS_PER_REPO, MAX_HIT_TEXT_LENGTH, } from './search-backend.js';
+/** GitHub 결과에는 줄 번호가 없다. 이 값이면 줄을 모른다는 뜻이다 */
+export const UNKNOWN_LINE = 0;
+/**
+ * repos에 이 값을 넣으면 목록 밖 레포의 결과도 남긴다. 받기만 하는 레포는 관련 레포 목록이
+ * 비어 있어서 조직 전체를 찾지 않으면 자기를 부르는 레포를 영영 못 찾는다
+ */
+export function orgWildcard(owner) {
+    return `${owner}/*`;
+}
+function quoteQuery(identifier) {
+    return `"${identifier.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+function hitsFromGithub(hit, identifier) {
+    const lines = hit.fragments.flatMap((f) => f.split('\n')).map((l) => l.trimEnd());
+    const matched = [...new Set(lines.filter((l) => l.includes(identifier)))];
+    // 조각에 식별자가 안 보여도 GitHub이 파일을 돌려줬다면 매치는 있다. 줄만 모를 뿐이다
+    const texts = matched.length > 0 ? matched : [lines.find((l) => l.trim() !== '') ?? ''];
+    return texts.map((text) => ({
+        repo: hit.repo,
+        path: hit.path,
+        line: UNKNOWN_LINE,
+        text: text.slice(0, MAX_HIT_TEXT_LENGTH),
+    }));
+}
+export class GithubCodeSearchAdapter {
+    kind = 'githubSearch';
+    capabilities;
+    /** 첫 막힘. 채워지면 이후 search는 gh를 부르지 않는다 */
+    blocked = null;
+    limitations = [...GH_SEARCH_LIMITATIONS, 'GitHub 결과에는 줄 번호가 없다'];
+    backend;
+    owner;
+    selfRepo;
+    constructor(opts) {
+        this.backend = opts.backend ?? createGithubSearchBackend(opts.gh);
+        this.owner = opts.owner;
+        this.selfRepo = opts.selfRepo?.toLowerCase();
+        this.capabilities = { ...this.backend.capabilities, orgWide: true, lineNumbers: false };
+    }
+    get rateLimitState() {
+        return this.backend.rateLimitState;
+    }
+    async search(identifier, repos, opts = {}) {
+        const result = { hits: [], skipped: [] };
+        if (identifier === '' || repos.length === 0)
+            return result;
+        if (!this.blocked) {
+            const outcome = this.backend.search(quoteQuery(identifier), {
+                owner: this.owner,
+                limit: GH_SEARCH_MAX_LIMIT,
+            });
+            if (outcome.status === 'blocked') {
+                this.blocked = { reason: outcome.reason, detail: outcome.detail };
+            }
+            else {
+                result.hits = this.filterHits(outcome.hits, identifier, repos, opts);
+                return result;
+            }
+        }
+        const reason = `GitHub 조회 막힘 (${this.blocked.reason})`;
+        result.skipped = repos.map((repo) => ({ repo, reason }));
+        return result;
+    }
+    filterHits(hits, identifier, repos, opts) {
+        const wanted = new Set(repos.map((r) => r.toLowerCase()));
+        const orgWide = this.owner !== null && wanted.has(orgWildcard(this.owner).toLowerCase());
+        const max = opts.maxHitsPerRepo ?? DEFAULT_MAX_HITS_PER_REPO;
+        const perRepo = new Map();
+        const seen = new Set();
+        const out = [];
+        for (const hit of hits) {
+            const repo = hit.repo.toLowerCase();
+            if (repo === this.selfRepo)
+                continue;
+            if (!orgWide && !wanted.has(repo))
+                continue;
+            for (const h of hitsFromGithub(hit, identifier)) {
+                const key = `${h.repo}\u0000${h.path}\u0000${h.text}`;
+                if (seen.has(key))
+                    continue;
+                const count = perRepo.get(repo) ?? 0;
+                if (count >= max)
+                    break;
+                seen.add(key);
+                perRepo.set(repo, count + 1);
+                out.push(h);
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=github-code-search.js.map

package/dist/src/harness-review/github-code-search.js.map

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

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

@@ -0,0 +1,75 @@
+import type { Identifier } from './types.js';
+export type DiffFileStatus = 'added' | 'deleted' | 'modified' | 'renamed';
+export interface DiffLine {
+    type: 'context' | 'removed' | 'added';
+    text: string;
+    /** removed와 context는 옛 파일 줄 번호, added는 새 파일 줄 번호 */
+    lineNumber: number;
+}
+export interface DiffHunk {
+    /** hunk 헤더의 옛 파일 시작 줄 */
+    oldStart: number;
+    /** hunk 헤더의 새 파일 시작 줄. 파일이 지워졌으면 0 */
+    newStart: number;
+    lines: DiffLine[];
+}
+export interface DiffFile {
+    oldPath: string | null;
+    newPath: string | null;
+    status: DiffFileStatus;
+    hunks: DiffHunk[];
+}
+/** `git diff` 출력(unified diff)을 파일 단위로 나눈다. */
+export declare function parseUnifiedDiff(diff: string): DiffFile[];
+/** 플러그인 매니페스트(plugin.json, marketplace.json)인가. */
+export declare function isPluginManifestPath(path: string): boolean;
+/**
+ * 다른 레포가 하네스로 읽는 경로인가. 역방향 검색 결과를 거르고 관련 레포 탐지가 읽을 문서를 고를 때 쓴다.
+ * SKILL.md, AGENT.md, CLAUDE.md, AGENTS.md, GEMINI.md, .mcp.json, 플러그인 매니페스트,
+ * .claude/, .agents/, .cursor/rules/, 플러그인 매니페스트 디렉토리 아래 파일,
+ * skills/와 plugins/ 아래 문서꼴 파일(md, mdc, json, toml, yaml, txt)이 해당한다.
+ */
+export declare function isHarnessPath(path: string): boolean;
+/**
+ * review 스킬 1단계가 이름만으로 ruleDocs에 넣는 경로인가.
+ * SKILL.md, AGENT.md, CLAUDE.md, AGENTS.md, GEMINI.md, .cursorrules, .windsurfrules,
+ * .claude/ 아래 .md, .cursor/rules/ 아래 파일.
+ */
+export declare function isRuleDocPath(path: string): boolean;
+export declare const MCP_SDK_PACKAGE = "@modelcontextprotocol/sdk";
+/** private가 아니고 name이 있는 package.json인가. 다른 레포가 이 이름으로 설치하거나 부른다. */
+export declare function isPublicPackageJson(path: string, content: string): boolean;
+/** package.json이 MCP SDK에 의존하는가. */
+export declare function dependsOnMcpSdk(packageJsonContent: string): boolean;
+/** 파일 내용에 MCP 도구 등록부 꼴(server.tool, registerTool, ListTools 핸들러)이 있는가. */
+export declare function isMcpToolRegistry(content: string): boolean;
+/** 소스에서 패턴으로 잡히는 MCP 도구 이름을 전부 뽑는다. 등록부가 아니면 name: 필드는 안 본다. */
+export declare function extractMcpToolNames(content: string): string[];
+export type ReadFileFn = (relPath: string) => string | undefined;
+export type HarnessTargetReason = 'ruleDoc' | 'mcpToolRegistry' | 'publicPackage';
+/**
+ * 변경 파일이 하네스 대상인지 판정한다. ruleDocs 꼴 문서이거나, 다른 레포가 이름으로 부르는
+ * 코드(MCP SDK에 의존하는 도구 등록부, private 아닌 package.json)면 그 이유를 돌려준다.
+ * content는 판정할 파일의 내용이다. readFile을 주면 가장 가까운 package.json의 의존성도 본다.
+ */
+export declare function classifyHarnessTarget(path: string, content?: string, readFile?: ReadFileFn): HarnessTargetReason | null;
+export interface ExtractIdentifiersOptions {
+    /** base 쪽 트리의 파일 목록. 레포에 하나뿐인 파일 이름을 판정할 때 쓴다. 없으면 uniqueFileName을 안 뽑는다. */
+    baseFiles?: string[];
+    /** 파일 내용을 읽는다. head에 없으면 base 내용을 돌려줘도 된다. */
+    readFile?: ReadFileFn;
+}
+/** 룰 문서에서 룰을 정의하는 줄이면 그 ID를 돌려준다. 규칙을 언급만 하는 줄은 정의로 안 본다 */
+export declare function ruleIdOfDefinitionLine(text: string): string | null;
+/**
+ * diff에서 지워지거나 바뀐 식별자를 뽑는다. 역방향 검색이 이 값으로 관련 레포를 찾는다.
+ * 하네스 문서 PR이 아니어도 MCP 도구 정의나 패키지 이름이 바뀌면 그 식별자가 나온다.
+ * 패턴으로 도구 이름을 못 잡은 MCP 등록부 변경은 value에 파일 경로를 담고 extractedBy=llm으로 표시한다.
+ */
+export declare function extractIdentifiers(diff: string, opts?: ExtractIdentifiersOptions): Identifier[];
+/**
+ * git 레포의 두 ref 사이 diff에서 식별자를 뽑는다. base 트리 파일 목록으로 하나뿐인 파일 이름을 판정하고
+ * 파일 내용은 head에서 먼저 읽고 없으면 base에서 읽는다.
+ */
+export declare function extractIdentifiersFromGit(repoRoot: string, baseRef: string, headRef: string): Identifier[];
+//# sourceMappingURL=identifiers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../../src/harness-review/identifiers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA+B,UAAU,EAAkB,MAAM,YAAY,CAAC;AAI1F,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AA+BD,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAoEzD;AAoBD,mDAAmD;AACnD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAcD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOnD;AAID,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAW3D,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI1E;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAQnE;AAWD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAYD,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7D;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAkBjE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,UAAU,GACpB,mBAAmB,GAAG,IAAI,CAY5B;AAID,MAAM,WAAW,yBAAyB;IACxC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAsHD,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIlE;AA6OD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,yBAA8B,GACnC,UAAU,EAAE,CAad;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CAuBd"}