adispatchd 0.0.0-stage → 0.1.0

package/dist/sources/github/adapter.js

@@ -0,0 +1,336 @@
+/**
+ * Source adapter `github` (Spec §5.2, §6, §10): issues and pull requests of
+ * one repository, native "blocked by" dependencies, labels and comments.
+ */
+import { SourceError, noopLogger, sourceItemKey, systemTimers, } from '../../core/index.js';
+import { DEPENDENCY_FIELDS, GITHUB_FIELD_DEFINITIONS } from './fields.js';
+import { GitHubHttpClient } from './http.js';
+import { pushdownQuery } from './pushdown.js';
+import { ITEM_ID_PATTERN, parseGitHubItemRef } from './refs.js';
+/** Adapter type name. */
+export const GITHUB_SOURCE_TYPE = 'github';
+/** Marker pattern accepted by {@link GitHubSourceAdapter.postComment} (see `commentMarker`). */
+const MARKER_PATTERN = /^[A-Za-z0-9_.:-]+$/;
+/** {@link SourceAdapter} for one GitHub repository. */
+export class GitHubSourceAdapter {
+    type = GITHUB_SOURCE_TYPE;
+    sourceId;
+    repository;
+    config;
+    http;
+    credentials;
+    logger;
+    repoPath;
+    constructor(sourceId, config, deps, options = {}) {
+        if (!config.owner || !config.repository)
+            throw new SourceError('invalid', `Source "${sourceId}": owner and repository are required`);
+        this.sourceId = sourceId;
+        this.config = config;
+        this.repository = `${config.owner}/${config.repository}`;
+        this.repoPath = `/repos/${encodeURIComponent(config.owner)}/${encodeURIComponent(config.repository)}`;
+        this.credentials = deps.credentials;
+        this.logger = (deps.logger ?? noopLogger).child({ component: 'source', sourceId });
+        this.http =
+            options.http ??
+                new GitHubHttpClient({
+                    ...options.httpOptions,
+                    clock: deps.clock,
+                    timers: options.timers ?? systemTimers,
+                    logger: this.logger,
+                    ...(deps.fetch ? { fetch: deps.fetch } : {}),
+                    ...(config.apiBaseUrl ? { baseUrl: config.apiBaseUrl } : {}),
+                });
+    }
+    fieldDefinitions() {
+        return GITHUB_FIELD_DEFINITIONS;
+    }
+    async listCandidates(options = {}) {
+        const query = pushdownQuery(options.filter);
+        const issues = await this.withToken(this.config.identity, options.signal, (token) => this.http.paginate(`${this.repoPath}/issues`, {
+            token,
+            query: {
+                state: query.state,
+                ...(query.labels.length > 0 ? { labels: query.labels.join(',') } : {}),
+                sort: 'created',
+                direction: 'asc',
+            },
+            ...(options.signal ? { signal: options.signal } : {}),
+        }));
+        return issues.map((issue) => this.toItem(issue));
+    }
+    async getItem(itemId, options = {}) {
+        const issue = await this.fetchIssue(itemId, this.config.identity, options.signal);
+        return issue ? this.toItem(issue) : null;
+    }
+    parseItemRef(ref) {
+        return parseGitHubItemRef(ref, this.config.owner, this.config.repository, this.config.webBaseUrl);
+    }
+    async resolveFields(item, fields, options = {}) {
+        const out = {};
+        const wantsDependencies = fields.some((f) => DEPENDENCY_FIELDS.includes(f));
+        const dependencies = wantsDependencies ? await this.resolveDependencies(item, options.signal) : undefined;
+        for (const name of fields) {
+            if (dependencies && name in dependencies) {
+                out[name] = dependencies[name];
+            }
+            else if (Object.hasOwn(item.fields, name)) {
+                out[name] = { known: true, value: item.fields[name] };
+            }
+            else {
+                out[name] = { known: false, reason: `unknown field "${name}" for source type github` };
+            }
+        }
+        return out;
+    }
+    async applyUpdate(item, update, identity) {
+        this.assertOwnItem(item);
+        const add = uniqueCaseInsensitive(update.labels?.add ?? []);
+        const addLower = new Set(add.map((l) => l.toLowerCase()));
+        // A label listed in both add and remove is added (remove ignored).
+        const remove = uniqueCaseInsensitive(update.labels?.remove ?? []).filter((l) => !addLower.has(l.toLowerCase()));
+        if (add.length === 0 && remove.length === 0)
+            return { changed: false };
+        // Re-read the item first so manual changes since the snapshot are respected (Spec §10).
+        const fresh = await this.fetchIssue(item.itemId, identity);
+        if (!fresh)
+            throw new SourceError('not_found', `Item ${this.repository}#${item.itemId} not found`, { retryable: false });
+        const current = labelNames(fresh);
+        const currentByLower = new Map(current.map((l) => [l.toLowerCase(), l]));
+        const toAdd = add.filter((l) => !currentByLower.has(l.toLowerCase()));
+        const toRemove = remove.map((l) => currentByLower.get(l.toLowerCase())).filter((l) => l !== undefined);
+        const issuePath = `${this.repoPath}/issues/${item.itemId}`;
+        if (toAdd.length > 0) {
+            await this.withToken(identity, undefined, (token) => 
+            // Adding labels is idempotent on GitHub's side: repeating is safe.
+            this.http.request('POST', `${issuePath}/labels`, { token, body: { labels: toAdd }, idempotent: true }));
+        }
+        const removed = [];
+        for (const label of toRemove) {
+            try {
+                await this.withToken(identity, undefined, (token) => this.http.request('DELETE', `${issuePath}/labels/${encodeURIComponent(label)}`, { token, idempotent: true }));
+                removed.push(label);
+            }
+            catch (err) {
+                // Already removed concurrently: desired state reached.
+                if (err instanceof SourceError && err.kind === 'not_found')
+                    continue;
+                throw err;
+            }
+        }
+        const changed = toAdd.length > 0 || removed.length > 0;
+        this.logger.info('Applied label update', { item: item.key, labelsAdded: toAdd, labelsRemoved: removed });
+        return {
+            changed,
+            ...(changed ? { applied: { labelsAdded: toAdd, labelsRemoved: removed } } : {}),
+        };
+    }
+    async postComment(item, body, marker, identity) {
+        this.assertOwnItem(item);
+        const markerLine = renderMarker(marker);
+        const fullBody = `${body.replace(/\s+$/, '')}\n\n${markerLine}`;
+        const res = await this.withToken(identity, undefined, (token) => this.http.request('POST', `${this.repoPath}/issues/${item.itemId}/comments`, {
+            token,
+            body: { body: fullBody },
+        }));
+        const id = res.data?.id;
+        if ((typeof id !== 'number' && typeof id !== 'string') || String(id) === '') {
+            // The comment may exist although the response is unusable: reconcile via marker.
+            throw new SourceError('transient', `Comment on ${item.key} returned no comment id; outcome unknown`, {
+                status: res.status,
+                outcomeUnknown: true,
+            });
+        }
+        return toCommentRef(res.data);
+    }
+    async findCommentByMarker(item, marker, identity) {
+        this.assertOwnItem(item);
+        const pattern = markerPattern(marker);
+        const comments = await this.withToken(identity, undefined, (token) => this.http.paginate(`${this.repoPath}/issues/${item.itemId}/comments`, { token }));
+        const isOwn = this.authorPredicate(identity);
+        const found = comments.find((c) => typeof c.body === 'string' && pattern.test(c.body) && isOwn(c));
+        return found ? toCommentRef(found) : null;
+    }
+    /**
+     * Only comments written by the identity's own app count as carrying a
+     * marker; otherwise anybody could suppress an orchestrator comment by
+     * posting the marker. With a known app ID (CredentialProvider.describe) the
+     * comment must have `performed_via_github_app.id === appId`; without one,
+     * at least a bot author (`user.type === 'Bot'`) is required.
+     */
+    authorPredicate(identity) {
+        const appId = this.credentials.describe?.(identity)?.appId;
+        if (appId !== undefined) {
+            return (c) => c.performed_via_github_app?.id !== undefined && String(c.performed_via_github_app.id) === appId;
+        }
+        return (c) => c.user?.type === 'Bot';
+    }
+    // -------------------------------------------------------------------------
+    async resolveDependencies(item, signal) {
+        this.assertOwnItem(item);
+        let issue;
+        let blockers;
+        try {
+            // Fresh issue (for the authoritative blocker count) and the visible blocker list.
+            [issue, blockers] = await Promise.all([
+                this.fetchIssue(item.itemId, this.config.identity, signal),
+                this.withToken(this.config.identity, signal, (token) => this.http.paginate(`${this.repoPath}/issues/${item.itemId}/dependencies/blocked_by`, {
+                    token,
+                    ...(signal ? { signal } : {}),
+                })),
+            ]);
+        }
+        catch (err) {
+            if (signal?.aborted)
+                throw err;
+            const reason = err instanceof SourceError ? `dependencies unavailable (${err.kind}): ${err.message}` : 'dependencies unavailable (unexpected error)';
+            this.logger.warn('Could not resolve dependencies', { item: item.key, reason });
+            return unknownDependencies(reason);
+        }
+        if (!issue)
+            return unknownDependencies(`item ${item.key} not found while resolving dependencies`);
+        const summaryTotal = issue.issue_dependencies_summary?.total_blocked_by;
+        if (typeof summaryTotal !== 'number' || !Number.isInteger(summaryTotal) || summaryTotal < 0) {
+            return unknownDependencies('issue_dependencies_summary missing; completeness of blockers cannot be verified');
+        }
+        let open = 0;
+        for (const blocker of blockers) {
+            if (blocker.state === 'open')
+                open += 1;
+            else if (blocker.state !== 'closed')
+                return unknownDependencies(`blocker with unexpected state "${String(blocker.state)}"`);
+        }
+        const total = blockers.length;
+        if (summaryTotal > total) {
+            // GitHub knows more blockers than this identity can see (e.g. cross-repo without access): fail closed.
+            return unknownDependencies(`${summaryTotal - total} of ${summaryTotal} blockers not visible to identity (missing access?)`);
+        }
+        return {
+            'dependencies.blocked_by_total': { known: true, value: total },
+            'dependencies.blocked_by_open': { known: true, value: open },
+            'dependencies.blocked': { known: true, value: open > 0 },
+            'dependencies.status': { known: true, value: 'ok' },
+        };
+    }
+    async fetchIssue(itemId, identity, signal) {
+        if (!ITEM_ID_PATTERN.test(itemId))
+            return null;
+        try {
+            const res = await this.withToken(identity, signal, (token) => this.http.request('GET', `${this.repoPath}/issues/${itemId}`, { token, ...(signal ? { signal } : {}) }));
+            // Transferred issues redirect to another repository: not an item of this source.
+            if (res.data.repository_url && !sameRepoUrl(res.data.repository_url, this.config.owner, this.config.repository))
+                return null;
+            return res.data;
+        }
+        catch (err) {
+            if (err instanceof SourceError && err.kind === 'not_found')
+                return null;
+            throw err;
+        }
+    }
+    /** Run `fn` with a token; on 401 invalidate the cached token and retry once. */
+    async withToken(identity, signal, fn) {
+        const first = await this.credentials.getToken(identity, signal ? { signal } : {});
+        try {
+            return await fn(first.token);
+        }
+        catch (err) {
+            if (!(err instanceof SourceError) || err.kind !== 'auth' || !this.credentials.invalidate)
+                throw err;
+            this.credentials.invalidate(identity);
+            const second = await this.credentials.getToken(identity, signal ? { signal } : {});
+            return fn(second.token);
+        }
+    }
+    toItem(issue) {
+        if (!Number.isInteger(issue.number) || issue.number <= 0) {
+            throw new SourceError('invalid', `GitHub returned an item without a valid number in ${this.repository}`);
+        }
+        const itemId = String(issue.number);
+        const isPr = issue.pull_request !== undefined && issue.pull_request !== null;
+        const url = issue.html_url ?? `${(this.config.webBaseUrl ?? 'https://github.com').replace(/\/+$/, '')}/${this.repository}/${isPr ? 'pull' : 'issues'}/${itemId}`;
+        return {
+            sourceId: this.sourceId,
+            itemId,
+            key: sourceItemKey(this.sourceId, itemId),
+            url,
+            type: isPr ? 'pull_request' : 'issue',
+            ...(issue.created_at ? { createdAt: issue.created_at } : {}),
+            fields: {
+                number: issue.number,
+                title: issue.title ?? '',
+                state: issue.state ?? null,
+                labels: labelNames(issue),
+                assignees: (issue.assignees ?? []).map((a) => a.login).filter((l) => typeof l === 'string'),
+                author: issue.user?.login ?? null,
+                is_pull_request: isPr,
+                created_at: issue.created_at ?? null,
+                updated_at: issue.updated_at ?? null,
+                url,
+                repository: this.repository,
+            },
+        };
+    }
+    assertOwnItem(item) {
+        if (item.sourceId !== this.sourceId || !ITEM_ID_PATTERN.test(item.itemId)) {
+            throw new SourceError('invalid', `Item ${item.key} does not belong to source "${this.sourceId}"`, { retryable: false });
+        }
+    }
+}
+/** Factory registered under type `github`. */
+export function createGitHubSourceFactory(options = {}) {
+    return {
+        type: GITHUB_SOURCE_TYPE,
+        create: (sourceId, config, deps) => new GitHubSourceAdapter(sourceId, config, deps, options),
+    };
+}
+/** Default factory (real timers). */
+export const githubSourceFactory = createGitHubSourceFactory();
+/** Render the HTML comment that carries an idempotency marker. */
+export function renderMarker(marker) {
+    if (!MARKER_PATTERN.test(marker))
+        throw new SourceError('invalid', 'Comment marker contains unsupported characters', { retryable: false });
+    return `<!-- ${marker} -->`;
+}
+/**
+ * Regex matching the marker as the LAST line of the body, i.e. the marker that
+ * `postComment` appends itself. A marker text inside the body (e.g. copied from
+ * untrusted worker output into the message) is followed by the real marker and
+ * therefore never matches — it cannot forge the idempotency check (WI-07 review).
+ */
+function markerPattern(marker) {
+    const line = renderMarker(marker).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`(^|\\n)[ \\t]*${line}\\s*$`);
+}
+function unknownDependencies(reason) {
+    return {
+        'dependencies.blocked_by_total': { known: false, reason },
+        'dependencies.blocked_by_open': { known: false, reason },
+        'dependencies.blocked': { known: false, reason },
+        // The status itself is always known: it says that the others are not.
+        'dependencies.status': { known: true, value: 'unknown' },
+    };
+}
+function labelNames(issue) {
+    return (issue.labels ?? [])
+        .map((l) => (typeof l === 'string' ? l : l.name))
+        .filter((l) => typeof l === 'string' && l !== '');
+}
+function uniqueCaseInsensitive(values) {
+    const seen = new Set();
+    const out = [];
+    for (const v of values) {
+        const k = v.toLowerCase();
+        if (v === '' || seen.has(k))
+            continue;
+        seen.add(k);
+        out.push(v);
+    }
+    return out;
+}
+function sameRepoUrl(repositoryUrl, owner, repo) {
+    return repositoryUrl.toLowerCase().endsWith(`/repos/${owner}/${repo}`.toLowerCase());
+}
+function toCommentRef(comment) {
+    return { id: String(comment.id), ...(comment.html_url ? { url: comment.html_url } : {}) };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/sources/github/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/sources/github/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,GAgBb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAgC,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEhE,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAiD3C,gGAAgG;AAChG,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAE5C,uDAAuD;AACvD,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAG,kBAAkB,CAAC;IAC1B,QAAQ,CAAS;IACjB,UAAU,CAAS;IACX,MAAM,CAAqB;IAC3B,IAAI,CAAmB;IACvB,WAAW,CAAqB;IAChC,MAAM,CAAS;IACf,QAAQ,CAAS;IAElC,YAAY,QAAgB,EAAE,MAA0B,EAAE,IAAuB,EAAE,OAAO,GAAyB,EAAE;QACnH,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,WAAW,QAAQ,sCAAsC,CAAC,CAAC;QACrI,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACzD,IAAI,CAAC,QAAQ,GAAG,UAAU,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACtG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI;YACP,OAAO,CAAC,IAAI;gBACZ,IAAI,gBAAgB,CAAC;oBACnB,GAAG,OAAO,CAAC,WAAW;oBACtB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,YAAY;oBACtC,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5C,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC7D,CAAC,CAAC;IACP,CAAC;IAED,gBAAgB;QACd,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAO,GAA0B,EAAE;QACtD,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAClF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAkB,GAAG,IAAI,CAAC,QAAQ,SAAS,EAAE;YAC7D,KAAK;YACL,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,KAAK;aACjB;YACD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CACH,CAAC;QACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAAO,GAA6B,EAAE;QAClE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAClF,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED,YAAY,CAAC,GAAW;QACtB,OAAO,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACpG,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,IAAgB,EAChB,MAAyB,EACzB,OAAO,GAA6B,EAAE;QAEtC,MAAM,GAAG,GAAoC,EAAE,CAAC;QAChD,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,iBAAuC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACnG,MAAM,YAAY,GAAG,iBAAiB,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1G,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,EAAE,CAAC;gBACzC,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAoB,CAAC;YACpD,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC5C,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAe,EAAE,CAAC;YACtE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,IAAI,0BAA0B,EAAE,CAAC;YACzF,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAgB,EAAE,MAAoB,EAAE,QAAqB;QAC7E,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC1D,mEAAmE;QACnE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAChH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAEvE,wFAAwF;QACxF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,QAAQ,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACzH,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAEpH,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,QAAQ,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YAClD,mEAAmE;YACnE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CACvG,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAClD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,SAAS,WAAW,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAC7G,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,uDAAuD;gBACvD,IAAI,GAAG,YAAY,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;oBAAE,SAAS;gBACrE,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QACzG,OAAO;YACL,OAAO;YACP,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAgB,EAAE,IAAY,EAAE,MAAc,EAAE,QAAqB;QACrF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,UAAU,EAAE,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAC9D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAoB,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,WAAW,IAAI,CAAC,MAAM,WAAW,EAAE;YAC9F,KAAK;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACzB,CAAC,CACH,CAAC;QACF,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;YAC5E,iFAAiF;YACjF,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,cAAc,IAAI,CAAC,GAAG,0CAA0C,EAAE;gBACnG,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,cAAc,EAAE,IAAI;aACrB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAgB,EAAE,MAAc,EAAE,QAAqB;QAC/E,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CACnE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAoB,GAAG,IAAI,CAAC,QAAQ,WAAW,IAAI,CAAC,MAAM,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CACpG,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnG,OAAO,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED;;;;;;OAMG;IACK,eAAe,CAAC,QAAqB;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;QAC3D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,wBAAwB,EAAE,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC;QAChH,CAAC;QACD,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,KAAK,CAAC;IACvC,CAAC;IAED,4EAA4E;IAEpE,KAAK,CAAC,mBAAmB,CAAC,IAAgB,EAAE,MAA+B;QACjF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,KAA6B,CAAC;QAClC,IAAI,QAA2B,CAAC;QAChC,IAAI,CAAC;YACH,kFAAkF;YAClF,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAC1D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CACrD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAkB,GAAG,IAAI,CAAC,QAAQ,WAAW,IAAI,CAAC,MAAM,0BAA0B,EAAE;oBACpG,KAAK;oBACL,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9B,CAAC,CACH;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,GAAG,CAAC;YAC/B,MAAM,MAAM,GACV,GAAG,YAAY,WAAW,CAAC,CAAC,CAAC,6BAA6B,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,6CAA6C,CAAC;YACxI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/E,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,OAAO,mBAAmB,CAAC,QAAQ,IAAI,CAAC,GAAG,yCAAyC,CAAC,CAAC;QAClG,MAAM,YAAY,GAAG,KAAK,CAAC,0BAA0B,EAAE,gBAAgB,CAAC;QACxE,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5F,OAAO,mBAAmB,CAAC,iFAAiF,CAAC,CAAC;QAChH,CAAC;QAED,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM;gBAAE,IAAI,IAAI,CAAC,CAAC;iBACnC,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAE,OAAO,mBAAmB,CAAC,kCAAkC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9H,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC9B,IAAI,YAAY,GAAG,KAAK,EAAE,CAAC;YACzB,uGAAuG;YACvG,OAAO,mBAAmB,CAAC,GAAG,YAAY,GAAG,KAAK,OAAO,YAAY,qDAAqD,CAAC,CAAC;QAC9H,CAAC;QACD,OAAO;YACL,+BAA+B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;YAC9D,8BAA8B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;YAC5D,sBAAsB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,EAAE;YACxD,qBAAqB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;SACpD,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,QAAqB,EAAE,MAAoB;QAClF,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAC3D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,KAAK,EAAE,GAAG,IAAI,CAAC,QAAQ,WAAW,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACzH,CAAC;YACF,iFAAiF;YACjF,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7H,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;gBAAE,OAAO,IAAI,CAAC;YACxE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,gFAAgF;IACxE,KAAK,CAAC,SAAS,CAAI,QAAqB,EAAE,MAA+B,EAAE,EAAiC;QAClH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,GAAG,YAAY,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU;gBAAE,MAAM,GAAG,CAAC;YACpG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnF,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAAsB;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,qDAAqD,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3G,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;QAC7E,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,oBAAoB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC;QACjK,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM;YACN,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC;YACzC,GAAG;YACH,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO;YACrC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,EAAE;gBACN,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;gBAC1B,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC;gBACzB,SAAS,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;gBACxG,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI;gBACjC,eAAe,EAAE,IAAI;gBACrB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;gBACpC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;gBACpC,GAAG;gBACH,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B;SACF,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,IAAgB;QACpC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,QAAQ,IAAI,CAAC,GAAG,+BAA+B,IAAI,CAAC,QAAQ,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1H,CAAC;IACH,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,UAAU,yBAAyB,CAAC,OAAO,GAAyB,EAAE;IAC1E,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;KAC7F,CAAC;AACJ,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAA6C,yBAAyB,EAAE,CAAC;AAEzG,kEAAkE;AAClE,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,gDAAgD,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3I,OAAO,QAAQ,MAAM,MAAM,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACzE,OAAO,IAAI,MAAM,CAAC,iBAAiB,IAAI,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,OAAO;QACL,+BAA+B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;QACzD,8BAA8B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;QACxD,sBAAsB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;QAChD,sEAAsE;QACtE,qBAAqB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAsB;IACxC,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAyB;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QACtC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,aAAqB,EAAE,KAAa,EAAE,IAAY;IACrE,OAAO,aAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,YAAY,CAAC,OAA0B;IAC9C,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAqB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/G,CAAC"}

package/dist/sources/github/fields.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Field catalogue of the GitHub source adapter (Spec §6, §17).
+ */
+import { type FieldDefinition } from '../../core/index.js';
+/** Names of the expensive dependency fields (resolved lazily via one API round trip). */
+export declare const DEPENDENCY_FIELDS: readonly ['dependencies.blocked_by_total', 'dependencies.blocked_by_open', 'dependencies.blocked', 'dependencies.status'];
+/** All fields provided by the GitHub adapter. */
+export declare const GITHUB_FIELD_DEFINITIONS: readonly FieldDefinition[];

package/dist/sources/github/fields.js

@@ -0,0 +1,72 @@
+/**
+ * Field catalogue of the GitHub source adapter (Spec §6, §17).
+ */
+import { OPERATORS_BY_TYPE } from '../../core/index.js';
+const STRING_OPS = OPERATORS_BY_TYPE.string;
+const NUMBER_OPS = OPERATORS_BY_TYPE.number;
+const BOOLEAN_OPS = OPERATORS_BY_TYPE.boolean;
+const DATE_OPS = OPERATORS_BY_TYPE.date;
+const LIST_OPS = OPERATORS_BY_TYPE['string[]'];
+/** Names of the expensive dependency fields (resolved lazily via one API round trip). */
+export const DEPENDENCY_FIELDS = [
+    'dependencies.blocked_by_total',
+    'dependencies.blocked_by_open',
+    'dependencies.blocked',
+    'dependencies.status',
+];
+/** All fields provided by the GitHub adapter. */
+export const GITHUB_FIELD_DEFINITIONS = Object.freeze([
+    { name: 'number', type: 'number', description: 'Issue/PR number', link: 'url', operators: NUMBER_OPS },
+    { name: 'title', type: 'string', description: 'Title', link: 'url', operators: STRING_OPS },
+    {
+        name: 'state',
+        type: 'string',
+        description: 'open | closed',
+        operators: STRING_OPS,
+        pushdown: ['equals', 'in'],
+    },
+    {
+        name: 'labels',
+        type: 'string[]',
+        description: 'Label names (compared case-insensitively, like GitHub)',
+        operators: LIST_OPS,
+        pushdown: ['contains'],
+        caseInsensitive: true,
+    },
+    { name: 'assignees', type: 'string[]', description: 'Assignee logins', operators: LIST_OPS },
+    { name: 'author', type: 'string', description: 'Login of the author', operators: STRING_OPS },
+    { name: 'is_pull_request', type: 'boolean', description: 'True for pull requests', operators: BOOLEAN_OPS },
+    { name: 'created_at', type: 'date', description: 'Creation time', operators: DATE_OPS },
+    { name: 'updated_at', type: 'date', description: 'Last update time', operators: DATE_OPS },
+    { name: 'url', type: 'string', description: 'Web URL', operators: STRING_OPS },
+    { name: 'repository', type: 'string', description: 'owner/name', operators: STRING_OPS },
+    {
+        name: 'dependencies.blocked_by_total',
+        type: 'number',
+        description: 'Number of issues blocking this one (native "blocked by", incl. cross-repo)',
+        operators: NUMBER_OPS,
+        expensive: true,
+    },
+    {
+        name: 'dependencies.blocked_by_open',
+        type: 'number',
+        description: 'Number of OPEN issues blocking this one; unknown without access',
+        operators: NUMBER_OPS,
+        expensive: true,
+    },
+    {
+        name: 'dependencies.blocked',
+        type: 'boolean',
+        description: 'True if at least one blocker is open; unknown without access',
+        operators: BOOLEAN_OPS,
+        expensive: true,
+    },
+    {
+        name: 'dependencies.status',
+        type: 'string',
+        description: '"ok" if dependencies were fully resolved, otherwise "unknown"',
+        operators: STRING_OPS,
+        expensive: true,
+    },
+]);
+//# sourceMappingURL=fields.js.map

package/dist/sources/github/fields.js.map

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

package/dist/sources/github/http.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Minimal GitHub REST client on top of an injectable `fetch` (no Octokit).
+ *
+ * - Pins the REST API version ({@link GITHUB_API_VERSION}) and the
+ *   `application/vnd.github+json` media type.
+ * - Maps HTTP failures to {@link SourceError} kinds (auth, forbidden,
+ *   not_found, rate_limited, transient, invalid). Messages never contain the
+ *   token or request headers (Spec §20.4).
+ * - Retries idempotent requests on transient errors and rate limits using the
+ *   injected {@link Timers}; mutating requests are never retried blindly and are
+ *   flagged `outcomeUnknown` when the request may have taken effect.
+ * - Follows `Link: <…>; rel="next"` pagination, but only within the API origin
+ *   so the token is never sent to a foreign host.
+ */
+import { type Clock, type FetchLike, type Logger, type Timers } from '../../core/index.js';
+/** Pinned GitHub REST API version (sent as `X-GitHub-Api-Version`). */
+export declare const GITHUB_API_VERSION = "2026-03-10";
+/** Default REST API base URL. */
+export declare const GITHUB_API_BASE_URL = "https://api.github.com";
+/** Media type requested from the API. */
+export declare const GITHUB_ACCEPT = "application/vnd.github+json";
+/** HTTP methods used by the orchestrator. */
+export type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+/** Options of {@link GitHubHttpClient}. */
+export interface GitHubHttpClientOptions {
+    /** HTTP implementation; defaults to the global `fetch`. */
+    fetch?: FetchLike;
+    clock: Clock;
+    /** Timers used for retry delays (inject a `FakeClock` in tests). */
+    timers?: Timers;
+    logger?: Logger;
+    /** API base URL, default {@link GITHUB_API_BASE_URL} (GHES: `https://host/api/v3`). */
+    baseUrl?: string;
+    /** Retries for idempotent requests (transient errors / rate limits). Default 2. */
+    maxRetries?: number;
+    /** Longest wait the client sleeps for a rate limit before giving up and throwing. Default 60 s. */
+    maxRetryWaitMs?: number;
+    /** Base delay for transient retries (exponential). Default 1 s. */
+    retryBaseDelayMs?: number;
+    /** Per-request timeout. Default 30 s. `0` disables it. */
+    requestTimeoutMs?: number;
+    /** Max pages followed by {@link GitHubHttpClient.paginate}. Default 50. */
+    maxPages?: number;
+    userAgent?: string;
+}
+/** Per-request options. */
+export interface GitHubRequestOptions {
+    /** Bearer token (installation token or app JWT). Never logged. */
+    token?: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    /** JSON body. */
+    body?: unknown;
+    signal?: AbortSignal;
+    /**
+     * Whether the request may be repeated safely. Default: true for GET,
+     * false otherwise. Rate-limit responses are retried regardless because
+     * the request was rejected before taking effect.
+     */
+    idempotent?: boolean;
+}
+/** Successful response. */
+export interface GitHubResponse<T> {
+    status: number;
+    data: T;
+    headers: Headers;
+}
+/** Default per-page size used for list endpoints. */
+export declare const DEFAULT_PER_PAGE = 100;
+/** GitHub REST client. One instance can be shared by adapters and credential providers. */
+export declare class GitHubHttpClient {
+    readonly baseUrl: string;
+    private readonly fetchImpl;
+    private readonly clock;
+    private readonly timers;
+    private readonly logger;
+    private readonly maxRetries;
+    private readonly maxRetryWaitMs;
+    private readonly retryBaseDelayMs;
+    private readonly requestTimeoutMs;
+    private readonly maxPages;
+    private readonly userAgent;
+    private readonly origin;
+    constructor(options: GitHubHttpClientOptions);
+    /** Perform one request (with retries for idempotent calls) and parse the JSON body. */
+    request<T = unknown>(method: HttpMethod, path: string, options?: GitHubRequestOptions): Promise<GitHubResponse<T>>;
+    /**
+     * GET all pages of a list endpoint by following `Link: rel="next"`.
+     * `per_page` defaults to {@link DEFAULT_PER_PAGE}.
+     */
+    paginate<T = unknown>(path: string, options?: Omit<GitHubRequestOptions, 'body' | 'idempotent'>): Promise<T[]>;
+    private buildUrl;
+    private nextPageUrl;
+    private requestUrl;
+    private once;
+    private toError;
+    /** Wait time from `Retry-After` (seconds) or `X-RateLimit-Reset` (epoch seconds). */
+    private retryAfter;
+}
+/** Parse an RFC 8288 `Link` header into `{ rel: url }`. */
+export declare function parseLinkHeader(header: string | null | undefined): Record<string, string>;