adispatchd 0.0.0-stage → 0.1.0

package/dist/sources/github/http.js

@@ -0,0 +1,288 @@
+/**
+ * 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 { SourceError, noopLogger, sleep, systemTimers, } from '../../core/index.js';
+/** Pinned GitHub REST API version (sent as `X-GitHub-Api-Version`). */
+export const GITHUB_API_VERSION = '2026-03-10';
+/** Default REST API base URL. */
+export const GITHUB_API_BASE_URL = 'https://api.github.com';
+/** Media type requested from the API. */
+export const GITHUB_ACCEPT = 'application/vnd.github+json';
+/** Default per-page size used for list endpoints. */
+export const DEFAULT_PER_PAGE = 100;
+/** GitHub REST client. One instance can be shared by adapters and credential providers. */
+export class GitHubHttpClient {
+    baseUrl;
+    fetchImpl;
+    clock;
+    timers;
+    logger;
+    maxRetries;
+    maxRetryWaitMs;
+    retryBaseDelayMs;
+    requestTimeoutMs;
+    maxPages;
+    userAgent;
+    origin;
+    constructor(options) {
+        this.baseUrl = (options.baseUrl ?? GITHUB_API_BASE_URL).replace(/\/+$/, '');
+        this.origin = new URL(this.baseUrl).origin;
+        this.fetchImpl = options.fetch ?? ((input, init) => fetch(input, init));
+        this.clock = options.clock;
+        this.timers = options.timers ?? systemTimers;
+        this.logger = options.logger ?? noopLogger;
+        this.maxRetries = options.maxRetries ?? 2;
+        this.maxRetryWaitMs = options.maxRetryWaitMs ?? 60_000;
+        this.retryBaseDelayMs = options.retryBaseDelayMs ?? 1_000;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
+        this.maxPages = options.maxPages ?? 50;
+        this.userAgent = options.userAgent ?? 'adispatchd';
+    }
+    /** Perform one request (with retries for idempotent calls) and parse the JSON body. */
+    async request(method, path, options = {}) {
+        const url = this.buildUrl(path, options.query);
+        return this.requestUrl(method, url, options);
+    }
+    /**
+     * GET all pages of a list endpoint by following `Link: rel="next"`.
+     * `per_page` defaults to {@link DEFAULT_PER_PAGE}.
+     */
+    async paginate(path, options = {}) {
+        const items = [];
+        let url = this.buildUrl(path, { per_page: DEFAULT_PER_PAGE, ...options.query });
+        let pages = 0;
+        while (url) {
+            if (pages >= this.maxPages) {
+                throw new SourceError('invalid', `Pagination limit of ${this.maxPages} pages exceeded for GET ${describePath(url)}`, {
+                    retryable: false,
+                });
+            }
+            const res = await this.requestUrl('GET', url, options);
+            pages += 1;
+            if (!Array.isArray(res.data)) {
+                throw new SourceError('invalid', `Expected a JSON array from GET ${describePath(url)}`, { status: res.status });
+            }
+            items.push(...res.data);
+            url = this.nextPageUrl(res.headers.get('link'));
+        }
+        return items;
+    }
+    buildUrl(path, query) {
+        const url = new URL(`${this.baseUrl}${path.startsWith('/') ? path : `/${path}`}`);
+        for (const [key, value] of Object.entries(query ?? {})) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        return url;
+    }
+    nextPageUrl(link) {
+        const next = parseLinkHeader(link).next;
+        if (!next)
+            return null;
+        let url;
+        try {
+            url = new URL(next);
+        }
+        catch {
+            return null;
+        }
+        if (url.origin !== this.origin) {
+            // Never forward the token to another host.
+            this.logger.warn('Ignoring pagination link to foreign origin', { origin: url.origin });
+            return null;
+        }
+        return url;
+    }
+    async requestUrl(method, url, options) {
+        const idempotent = options.idempotent ?? method === 'GET';
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await this.once(method, url, options, idempotent);
+            }
+            catch (err) {
+                if (!(err instanceof SourceError) || options.signal?.aborted)
+                    throw err;
+                const retryAllowed = err.kind === 'rate_limited' || (idempotent && err.kind === 'transient');
+                if (!retryAllowed || attempt >= this.maxRetries)
+                    throw err;
+                const delay = err.kind === 'rate_limited'
+                    ? (err.retryAfterMs ?? this.retryBaseDelayMs)
+                    : (err.retryAfterMs ?? this.retryBaseDelayMs * 2 ** attempt);
+                if (delay > this.maxRetryWaitMs)
+                    throw err;
+                this.logger.warn('GitHub request failed, retrying', {
+                    method,
+                    path: describePath(url),
+                    kind: err.kind,
+                    status: err.status,
+                    attempt: attempt + 1,
+                    delayMs: delay,
+                });
+                await sleep(this.timers, delay, options.signal);
+            }
+        }
+    }
+    async once(method, url, options, idempotent) {
+        const headers = {
+            Accept: GITHUB_ACCEPT,
+            'X-GitHub-Api-Version': GITHUB_API_VERSION,
+            'User-Agent': this.userAgent,
+        };
+        if (options.token)
+            headers.Authorization = `Bearer ${options.token}`;
+        let body;
+        if (options.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            body = JSON.stringify(options.body);
+        }
+        const signals = [];
+        if (options.signal)
+            signals.push(options.signal);
+        if (this.requestTimeoutMs > 0)
+            signals.push(AbortSignal.timeout(this.requestTimeoutMs));
+        const signal = signals.length === 0 ? undefined : signals.length === 1 ? signals[0] : AbortSignal.any(signals);
+        const label = `${method} ${describePath(url)}`;
+        let res;
+        try {
+            res = await this.fetchImpl(url.toString(), { method, headers, ...(body !== undefined ? { body } : {}), ...(signal ? { signal } : {}) });
+        }
+        catch (err) {
+            if (options.signal?.aborted)
+                throw options.signal.reason ?? err;
+            const timedOut = err instanceof Error && (err.name === 'TimeoutError' || err.name === 'AbortError');
+            // Never include the raw error: some fetch implementations echo request details.
+            throw new SourceError('transient', `${label} failed: ${timedOut ? 'request timed out' : 'network error'}`, {
+                outcomeUnknown: !idempotent,
+                details: { method, path: describePath(url) },
+            });
+        }
+        const text = await safeText(res);
+        if (res.ok) {
+            let data = null;
+            if (text.length > 0) {
+                try {
+                    data = JSON.parse(text);
+                }
+                catch {
+                    // For a mutating request the change may have been applied although the body is unusable.
+                    throw idempotent
+                        ? new SourceError('invalid', `${label} returned invalid JSON`, { status: res.status, retryable: false })
+                        : new SourceError('transient', `${label} returned invalid JSON; outcome unknown`, {
+                            status: res.status,
+                            outcomeUnknown: true,
+                        });
+                }
+            }
+            return { status: res.status, data: data, headers: res.headers };
+        }
+        throw this.toError(res, text, label, idempotent);
+    }
+    toError(res, text, label, idempotent) {
+        const status = res.status;
+        const apiMessage = extractMessage(text);
+        const message = `${label} failed with HTTP ${status}${apiMessage ? `: ${apiMessage}` : ''}`;
+        const details = { status, path: label.slice(label.indexOf(' ') + 1) };
+        const retryAfterMs = this.retryAfter(res.headers);
+        const rateLimited = status === 429 ||
+            (status === 403 &&
+                (res.headers.get('x-ratelimit-remaining') === '0' ||
+                    res.headers.has('retry-after') ||
+                    /rate limit/i.test(apiMessage ?? '')));
+        if (rateLimited) {
+            return new SourceError('rate_limited', message, {
+                status,
+                details,
+                retryAfterMs: retryAfterMs ?? 60_000,
+            });
+        }
+        if (status === 401)
+            return new SourceError('auth', message, { status, details });
+        if (status === 403)
+            return new SourceError('forbidden', message, { status, details });
+        if (status === 404 || status === 410)
+            return new SourceError('not_found', message, { status, details });
+        if (status >= 500) {
+            return new SourceError('transient', message, {
+                status,
+                details,
+                outcomeUnknown: !idempotent,
+                ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+            });
+        }
+        return new SourceError('invalid', message, { status, details });
+    }
+    /** Wait time from `Retry-After` (seconds) or `X-RateLimit-Reset` (epoch seconds). */
+    retryAfter(headers) {
+        const retryAfter = headers.get('retry-after');
+        if (retryAfter !== null) {
+            const seconds = Number(retryAfter);
+            if (Number.isFinite(seconds) && seconds >= 0)
+                return Math.ceil(seconds * 1000);
+        }
+        const reset = headers.get('x-ratelimit-reset');
+        if (reset !== null && headers.get('x-ratelimit-remaining') === '0') {
+            const resetMs = Number(reset) * 1000;
+            if (Number.isFinite(resetMs))
+                return Math.max(0, resetMs - this.clock.now().getTime()) + 1_000;
+        }
+        return undefined;
+    }
+}
+/** Parse an RFC 8288 `Link` header into `{ rel: url }`. */
+export function parseLinkHeader(header) {
+    const out = {};
+    if (!header)
+        return out;
+    for (const part of header.split(',')) {
+        const match = /<([^>]*)>\s*;(.*)/.exec(part.trim());
+        if (!match)
+            continue;
+        const [, url, params] = match;
+        const rel = /rel="?([^";]+)"?/.exec(params ?? '');
+        if (url !== undefined && rel?.[1]) {
+            for (const name of rel[1].trim().split(/\s+/))
+                out[name] = url;
+        }
+    }
+    return out;
+}
+/** Path (without query string) for messages; query strings could contain user data only, but stay short. */
+function describePath(url) {
+    return url.pathname;
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return '';
+    }
+}
+function extractMessage(text) {
+    if (!text)
+        return undefined;
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed.message === 'string')
+            return truncate(parsed.message, 200);
+    }
+    catch {
+        // non-JSON error body: do not echo arbitrary content
+    }
+    return undefined;
+}
+function truncate(text, max) {
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+//# sourceMappingURL=http.js.map

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

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

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

@@ -0,0 +1,6 @@
+/** GitHub source adapter (WI-06). */
+export * from './adapter.js';
+export * from './fields.js';
+export * from './http.js';
+export * from './pushdown.js';
+export * from './refs.js';

package/dist/sources/github/index.js

@@ -0,0 +1,7 @@
+/** GitHub source adapter (WI-06). */
+export * from './adapter.js';
+export * from './fields.js';
+export * from './http.js';
+export * from './pushdown.js';
+export * from './refs.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sources/github/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Conservative filter pushdown into `GET /repos/{o}/{r}/issues` query
+ * parameters. Only top-level conjunctions are considered; everything else is
+ * evaluated locally by the caller (the result may be a superset).
+ */
+import { type FilterNode } from '../../core/index.js';
+/** Query parameters derived from a filter. */
+export interface IssueListQuery {
+    state: 'open' | 'closed' | 'all';
+    /** Labels that must all be present (GitHub `labels=a,b` is a conjunction). */
+    labels: string[];
+}
+/** Derive list query parameters from `filter`; default `state=open`. */
+export declare function pushdownQuery(filter: FilterNode | undefined): IssueListQuery;

package/dist/sources/github/pushdown.js

@@ -0,0 +1,47 @@
+/**
+ * Conservative filter pushdown into `GET /repos/{o}/{r}/issues` query
+ * parameters. Only top-level conjunctions are considered; everything else is
+ * evaluated locally by the caller (the result may be a superset).
+ */
+import { isFilterAll, isFilterPredicate } from '../../core/index.js';
+/** Derive list query parameters from `filter`; default `state=open`. */
+export function pushdownQuery(filter) {
+    const query = { state: 'open', labels: [] };
+    if (!filter)
+        return query;
+    const conjuncts = isFilterPredicate(filter)
+        ? [filter]
+        : isFilterAll(filter)
+            ? filter.all.filter(isFilterPredicate)
+            : [];
+    for (const p of conjuncts) {
+        if (p.field === 'labels' && p.operator === 'contains' && typeof p.value === 'string') {
+            // Commas cannot be expressed in the comma-separated `labels` parameter.
+            if (p.value !== '' && !p.value.includes(',') && !query.labels.includes(p.value))
+                query.labels.push(p.value);
+        }
+        else if (p.field === 'state') {
+            const states = stateSet(p);
+            if (states)
+                query.state = states;
+        }
+    }
+    return query;
+}
+function stateSet(p) {
+    if (p.operator === 'equals' && (p.value === 'open' || p.value === 'closed'))
+        return p.value;
+    if (p.operator === 'in' && Array.isArray(p.value)) {
+        const values = new Set(p.value);
+        const open = values.has('open');
+        const closed = values.has('closed');
+        if (open && closed)
+            return 'all';
+        if (open)
+            return 'open';
+        if (closed)
+            return 'closed';
+    }
+    return undefined;
+}
+//# sourceMappingURL=pushdown.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pushdown.js","sourceRoot":"","sources":["../../../src/sources/github/pushdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAyC,MAAM,qBAAqB,CAAC;AAS5G,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,MAA8B;IAC1D,MAAM,KAAK,GAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC5D,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,SAAS,GAAsB,iBAAiB,CAAC,MAAM,CAAC;QAC5D,CAAC,CAAC,CAAC,MAAM,CAAC;QACV,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;YACnB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC;YACtC,CAAC,CAAC,EAAE,CAAC;IACT,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrF,wEAAwE;YACxE,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9G,CAAC;aAAM,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,MAAM;gBAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,CAAkB;IAClC,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IAC5F,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,IAAI,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC;QACjC,IAAI,IAAI;YAAE,OAAO,MAAM,CAAC;QACxB,IAAI,MAAM;YAAE,OAAO,QAAQ,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Parsing of user-supplied item references for a GitHub source.
+ */
+/** Pattern of a valid GitHub item ID (issue/PR number as decimal string). */
+export declare const ITEM_ID_PATTERN: RegExp;
+/**
+ * Parse `ref` into an item ID (issue/PR number) of the repository
+ * `owner/repo`, or `null`. Accepted forms:
+ * - `123`, `#123`
+ * - `owner/repo#123`
+ * - `https://github.com/owner/repo/issues/123` and `/pull/123`
+ *   (optional trailing path such as `/files`, query and fragment)
+ *
+ * Owner and repository are compared case-insensitively (GitHub semantics);
+ * references to other repositories yield `null`.
+ */
+export declare function parseGitHubItemRef(ref: string, owner: string, repo: string, webBaseUrl?: string): string | null;

package/dist/sources/github/refs.js

@@ -0,0 +1,61 @@
+/**
+ * Parsing of user-supplied item references for a GitHub source.
+ */
+/** Pattern of a valid GitHub item ID (issue/PR number as decimal string). */
+export const ITEM_ID_PATTERN = /^[1-9]\d{0,9}$/;
+/**
+ * Parse `ref` into an item ID (issue/PR number) of the repository
+ * `owner/repo`, or `null`. Accepted forms:
+ * - `123`, `#123`
+ * - `owner/repo#123`
+ * - `https://github.com/owner/repo/issues/123` and `/pull/123`
+ *   (optional trailing path such as `/files`, query and fragment)
+ *
+ * Owner and repository are compared case-insensitively (GitHub semantics);
+ * references to other repositories yield `null`.
+ */
+export function parseGitHubItemRef(ref, owner, repo, webBaseUrl = 'https://github.com') {
+    const text = ref.trim();
+    const bare = /^#?(\d+)$/.exec(text);
+    if (bare)
+        return normalizeNumber(bare[1]);
+    const short = /^([A-Za-z0-9-]+)\/([A-Za-z0-9._-]+)#(\d+)$/.exec(text);
+    if (short)
+        return sameRepo(short[1], short[2], owner, repo) ? normalizeNumber(short[3]) : null;
+    let url;
+    try {
+        url = new URL(text);
+    }
+    catch {
+        return null;
+    }
+    const base = new URL(webBaseUrl);
+    if (url.protocol !== 'https:' && url.protocol !== 'http:')
+        return null;
+    if (url.host.toLowerCase() !== base.host.toLowerCase())
+        return null;
+    const basePath = base.pathname.replace(/\/+$/, '');
+    if (!url.pathname.startsWith(`${basePath}/`))
+        return null;
+    const segments = url.pathname.slice(basePath.length + 1).split('/');
+    const [o, r, kind, number] = segments;
+    if (o === undefined || r === undefined || number === undefined)
+        return null;
+    if (kind !== 'issues' && kind !== 'pull' && kind !== 'pulls')
+        return null;
+    if (!sameRepo(o, r, owner, repo))
+        return null;
+    if (!/^\d+$/.test(number))
+        return null;
+    return normalizeNumber(number);
+}
+function sameRepo(o, r, owner, repo) {
+    return o?.toLowerCase() === owner.toLowerCase() && r?.toLowerCase() === repo.toLowerCase();
+}
+function normalizeNumber(digits) {
+    if (digits === undefined)
+        return null;
+    const normalized = digits.replace(/^0+/, '');
+    return ITEM_ID_PATTERN.test(normalized) ? normalized : null;
+}
+//# sourceMappingURL=refs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../../src/sources/github/refs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,KAAa,EAAE,IAAY,EAAE,UAAU,GAAG,oBAAoB;IAC5G,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,IAAI;QAAE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAG,4CAA4C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,KAAK;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE/F,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;QAAE,OAAO,IAAI,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC;IACtC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5E,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1E,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,QAAQ,CAAC,CAAqB,EAAE,CAAqB,EAAE,KAAa,EAAE,IAAY;IACzF,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;AAC7F,CAAC;AAED,SAAS,eAAe,CAAC,MAA0B;IACjD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC"}

package/dist/sources/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Component `sources` – public API (WI-06).
+ * Other components import from this module only. Test doubles live in
+ * `src/sources/github/testing/` (not part of the build).
+ */
+export * from './github/index.js';

package/dist/sources/index.js

@@ -0,0 +1,7 @@
+/**
+ * Component `sources` – public API (WI-06).
+ * Other components import from this module only. Test doubles live in
+ * `src/sources/github/testing/` (not part of the build).
+ */
+export * from './github/index.js';
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,mBAAmB,CAAC"}

package/dist/ui/index.d.ts

@@ -0,0 +1,12 @@
+/** Entry module of the built UI, relative to the UI directory. */
+export declare const UI_ENTRY = "js/client/app.js";
+/** True if `dir` contains a complete built UI (index.html + compiled entry). */
+export declare function isUiDir(dir: string): boolean;
+/**
+ * Locate the built web UI:
+ * 1. `<this module>/public` – `dist/ui/public` when running from `dist/`;
+ * 2. `<repo>/dist/ui/public` – when running from sources (`tsx src/cli/main.ts`)
+ *    after `npm run build` / `npm run build:ui`.
+ * Returns `null` if no built UI exists (the API then runs without UI).
+ */
+export declare function resolveUiDir(moduleUrl?: string): string | null;

package/dist/ui/index.js

@@ -0,0 +1,28 @@
+/**
+ * Component `ui` – public API (WI-11). The browser code lives in
+ * `src/ui/client` + `src/ui/shared` and is compiled by `tsconfig.ui.json`;
+ * `npm run build` writes the complete static UI to `dist/ui/public`.
+ * Other components import from this module only.
+ */
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Entry module of the built UI, relative to the UI directory. */
+export const UI_ENTRY = 'js/client/app.js';
+/** True if `dir` contains a complete built UI (index.html + compiled entry). */
+export function isUiDir(dir) {
+    return existsSync(path.join(dir, 'index.html')) && existsSync(path.join(dir, UI_ENTRY));
+}
+/**
+ * Locate the built web UI:
+ * 1. `<this module>/public` – `dist/ui/public` when running from `dist/`;
+ * 2. `<repo>/dist/ui/public` – when running from sources (`tsx src/cli/main.ts`)
+ *    after `npm run build` / `npm run build:ui`.
+ * Returns `null` if no built UI exists (the API then runs without UI).
+ */
+export function resolveUiDir(moduleUrl = import.meta.url) {
+    const here = path.dirname(fileURLToPath(moduleUrl));
+    const candidates = [path.join(here, 'public'), path.resolve(here, '..', '..', 'dist', 'ui', 'public')];
+    return candidates.find(isUiDir) ?? null;
+}
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,kEAAkE;AAClE,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAE3C,gFAAgF;AAChF,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,SAAS,GAAW,OAAO,IAAI,CAAC,GAAG;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvG,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAC1C,CAAC"}